Re: [sfWiki-devel] release plan

[Iain S. <iai...@ya...>]

On 30 May 00, at 18:48, Todd L. Miller wrote:

> 	Yup.  The documentation is in dire need of work.  Maybe you/we
> should get root for Clark's box and record the administator/deployer side
> of things.  (Once I've done something, it becomes very difficult to make
> sure I record /everything/ I'm doing the second, especially if I forgot to
> reset something.)  I'll write the programmer's guide, and we can leave the
> user's guide up in the air for now.

Sounds like a plan.  I'm hoping to have some time to setup a linux 
box at home and I could easily document the process of installing 
things.  Of course, I can't see that happening for at least a few 
weeks so if it comes up as the 'next thing to do' and I'm not ready, 
we should probably just use someone else's box.

> > And now that we have a 'safe' wiki, another major documentation
> > effort.
> 
> 	Indeed.  Perhaps I should add to the file-release reorganization,
> include documentation package(s).  (Add a 'documentation' task list?)

Yes.  I agree.  I can imagine people wanting to download the 
documentation set without the wiki source (they need to access, 
maintain, program an existing sfwiki installation...)

> 	This is good.  You've noted before that most wiki's eventually
> become rather static.  (And I imagine for those with slow links, d/l'ing a
> tarball over lunch break will be a more satisfying way of browsing
> anyway.)

Yup.  Plus, if you have something like JOS's 'technical 
distributions' its nice to include a browsable snapshot of the wiki 
which basically is the documentation for the project.

-iain