All,
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
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 :-(
vladimir
Vladimir Kosovac wrote:
All,
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
On Nov 3, 2007 1:09 AM, Vladimir Kosovac vnk@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