Greetings Tom, It seems you're right that the main problem with maintaining the manual is apathy rather than access, judging by the deafening silence in response from your request for responses.
In that case, how can I get access to the manual to fix some of the errors? Also, would it be possible to have a "beta" version of the manual as well as the "stable" version? That might help to push it towards the wiki ideal of a work-in-continual-progress, without the labour of changing the mark-up. The beta could have both new contributions from newbies, to be checked for accuracy by the veterans before inclusion, and also annotation such as requests for clarification and draft documentation of new features. Thanks, Lachlan ns-users-requ...@isi.edu wrote: > > Message: 7 > Date: Fri, 19 Dec 2008 12:52:21 -0800 > From: Tom Henderson <tomh at tomh.org> > Subject: Re: [ns] NS manual to wiki > To: Lachlan Andrew <landrew at swin.edu.au> > Cc: ns-users@ISI.EDU > Message-ID: <494c0985.7060...@tomh.org> > Content-Type: text/plain; charset=ISO-8859-1; format=flowed > > Lachlan Andrew wrote: >> Greetings all, >> >> The NS manual seems rather out of date. (There are comments from 2001 >> about "changes in the near future", and snippets of code that have >> changed radically, and references to files that no longer exist.) >> >> I have started copying the contents from the PDF to the wiki, at >> <http://nsnam.isi.edu/nsnam/index.php/NS_manual>, with the hope that >> the community can keep it more up-to-date. >> >> Does this seem useful, or is the "manual" seen as no longer important? >> If it is useful, would anyone like to volunteer to help? :) > > Lachlan, > > Thanks for taking the initiative to do that. But I'd like to ask > whether the real issue is the markup (tex vs wiki) or the accessibility > to make changes, or whether the issue is that no one wants to update the > documentation. Because it would be a shame for you or anyone to invest > a lot of resources in a migration if the result would be the same. > > Personally, I have been updating manual chapters as new things were > checked in (see the wifi updates in section 16.3) and asking new > contributors to write manual chapters (see section 43 for Tmix). But, I > realize there are large portions of the manual written over 8 years ago > that have not been maintained. > > Are there people in the community who would be more inclined to update > documentation if the contents were on the wiki (please speak up)? Or is > that not the real issue? > > - Tom > > > > ------------------------------ > > _______________________________________________ > Ns-users mailing list > Ns-users@isi.edu > http://mailman.isi.edu/mailman/listinfo/ns-users > > > End of Ns-users Digest, Vol 60, Issue 20 > **************************************** -- Lachlan Andrew Centre for Advanced Internet Architectures (CAIA) Swinburne University of Technology, Melbourne, Australia <http://caia.swin.edu.au/cv/landrew> <http://netlab.caltech.edu/lachlan> Ph +61 3 9214 4837
