AdminGuide work

John Babich jmbabich at gmail.com
Sat Nov 10 18:54:21 UTC 2007


On Nov 3, 2007 1:09 AM, Vladimir Kosovac <vnk at mkc.co.nz> wrote:
> > I have just started Samba write-up for the Servers section in the Wiki.
> > It's sandboxed at the moment, once I have complete layout and more
> > content I shall copy it to Drafts.
> >
> > One question: some of the newer (like DNS) AdminGuide sections use the
> > old layout, with TOCs but some others don't (like MailServer). My
> > understanding is that we should avoid TOCs and multiple pages to ease
> > wiki-->DocBook conversion. Is that correct?
> >

Vladimir, sorry for the delay in responding.

As one who sees the value of wiki writing and appreciates the power of
DocBook XML, I still like to use the wiki table of contents macro and
multiple wiki pages. I find it helps me organize my thoughts. However,
you should do whatever works for you.

If you would like other people to contribute to the Samba section, I
would encourage you to move your section to the Docs Draft area for
the Admin Guide.

> BTW, I just figured how tough is this one going to be - word 'windows'
> will be used more times in this section alone than in the rest of the
> wiki put together :-(

That's a burden you must bear writing about Samba :-)

John Babich
Volunteer, Fedora Docs Project




More information about the fedora-docs-list mailing list