Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 113928 - Major changes should be documented in an online, human-readable fashion
Summary: Major changes should be documented in an online, human-readable fashion
Status: RESOLVED WONTFIX
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Handbook (show other bugs)
Hardware: All Linux
: High enhancement (vote)
Assignee: Docs Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-11-29 11:26 UTC by michael@smith-li.com
Modified: 2005-11-29 13:45 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description michael@smith-li.com 2005-11-29 11:26:37 UTC
For example, many non-newbies are missing the fact that stages 1 & 2 have been
deprecated, and they're asking about it in #gentoo. I think there should be an
online doc that describes recent changes (<1 year?) to the handbook.

Reproducible: Always
Steps to Reproduce:




I don't think it's unreasonable for an experienced user to expect to be able to
do an install without re-reading the entire handbook.
Comment 1 Ian P. Christian 2005-11-29 12:10:09 UTC
I agree.
Comment 2 Xavier Neys (RETIRED) gentoo-dev 2005-11-29 12:59:00 UTC
(In reply to comment #0)
> For example, many non-newbies are missing the fact that stages 1 & 2 have been
> deprecated, and they're asking about it in #gentoo. I think there should be an
> online doc that describes recent changes (<1 year?) to the handbook.

"Instructions on using a stage1 or stage2 tarball are now available in the
Gentoo FAQ. A stage3 installation is the only supported installation as of now."
is darn explicit, isn't it?
It's been announced on our front page (GWN 2005-11-14), it's been discussed in
the forums and in plenty other places. Adding more noise will not help.
Besides, experienced Gentooers can use the quick install guide.
Comment 3 michael@smith-li.com 2005-11-29 13:17:17 UTC
That'll teach me to leave examples. No, I'm not talking specifically about the
stage 1 and 2 deprecation, it's *just a good example* -- I'm talking about in
general, when the handbook changes, a *single* source for reviewing those changes.

Please forget that I mentioned the stage deprecations, and reopen this bug.
Comment 4 Jan Kundrát (RETIRED) gentoo-dev 2005-11-29 13:45:23 UTC
(In reply to comment #3) 
> That'll teach me to leave examples. No, I'm not talking specifically about 
the 
> stage 1 and 2 deprecation, it's *just a good example* -- I'm talking about in 
> general, when the handbook changes, a *single* source for reviewing those 
changes. 
>  
> Please forget that I mentioned the stage deprecations, and reopen this bug. 
 
http://viewcvstest.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/ 
 
Sorry, but we won't double existing resources. It would only cause a lot of 
extra work.