I added a 3rd note to http://twiki.org/cgi-bin/view/Wikilearn/HowYouCanHelp, as follows, to explicitly address the point of information becoming obsolete. The procedure is just one possibility, it is not cast in concrete.
<quote> 3. As information goes out of date, and new information applies to new releases, I plan to preserve some old pages and implement a naming convention to identify old and new information. One possible scenario: A question answered about kde 3.0 might be answered on a page named ToastingRyeBreadWithKde. When kde 3.1 comes out, we might copy that entire page to a page named ToastingRyeBreadWithKde30, and add a note to the ToastingRyeBreadWithKde page saying that the information was developed for kde 3.0 and may need modification for 3.1. As time goes on, the page will (should) get modified appropriately. At the next release of kde, the process is repeated. </quote> Randy Kramer Randy Kramer wrote: > > et wrote: > > the "moving target" that a (IMHO) good Linux Distro should be is one of the > > greatest problems with creating "book" documentation, I would guess. by the > > time the reasearch and writting and printing and distribution of the paper > > goes out, it would be time for the next distro, with a number of improvments > > that would render the old book about as good as a 1970 phone book for Miami. > > the stuff flat out changed. > > It has been my experiance that the best documentation I can find is either > > refered to on is in this mail list (and the newbie list for installation) and > > some of the least fricton of any "help" method. > > I'm hoping WikiLearn can help address this problem. It's not there yet, > by any means, but take a look at > http://twiki.org/cgi-bin/view/Wikilearn/AboutThesePages. > > You can help, in any of these ways: > > * If you have a question, try seeing if it's answered on WikiLearn -- > try http://twiki.org/cgi-bin/search/Wikilearn, or just click on search > from any WikiLearn page. (Or try a Google search with site:twiki.org or > site:twiki.sourceforge.net in the search query.) > * If it's not answered (or you don't think it's answered, after at > least some attempt at a search), try creating a WikiLearn page with the > question on it. Post to expert (newbie, or any other mail list), saying > that you have a question about such and such and it's posted at > http://twiki.org/cgi-bin/view/Wikilearn/<name of WikiLearn page>. > Suggest that people answer the question on that page. > * Register to edit WikiLearn at > http://twiki.org/cgi-bin/view/TWiki/TWikiRegistration. > * Subscribe to get a daily notification of page changes at > http://twiki.org/cgi-bin/view/Wikilearn/WebNotify. > * If you can answer a question, or help answer a question, edit the > page with the question appropriately. > * If you are experienced in Linux, Perl, cgi, html, and other good > stuff, help me move WikiLearn to it's "permanent" location on > SourceForge. Do a TWiki search on "ToDo" in page (topic) names, or > help me set up utilities and procedures for things like backups and so > forth. > > Notes: > > 1. Pages can be renamed, so if the initial name for a page is not > intuitive / descriptive enough, the page name can be changed. Usually, > it is a good idea to recreate the original page, delete all the > "boilerplate text", and put a note there saying "Moved to <name of new > WikiLearn page>. > > 2. WikiLearn is indexed on Google and similar web search engines. On > Google, WikiLearn is indexed under two different domains, twiki.org and > twiki.sourceforge.net. Last time I checked, the update cycle was 4 to 8 > weeks, fortunately, sometimes the two domains are indexed at different > times, thus (sort of) indexing the site twice as often. > > The content of this email has been moved to a WikiLearn page: > http://twiki.org/cgi-bin/view/Wikilearn/HowYouCanHelp. > > Randy Kramer > > --------------------------------------------------------------- > Want to buy your Pack or Services from MandrakeSoft? > Go to http://www.mandrakestore.com
Want to buy your Pack or Services from MandrakeSoft? Go to http://www.mandrakestore.com
