On 08/26/2011 10:55 AM, Adam Stokes wrote:
On Thu, 25 Aug 2011 13:10:54 -0400
Russell Bryant<rbryant(a)redhat.com> wrote:
> On 08/25/2011 10:41 AM, Adam Stokes wrote:
>> Updated the kerberos wiki page to include k5start and make it
>> easier to navigate. I basically put the instructions in "steps" but
>> if there is a need to have the steps labeled out in the TOC im fine
>> with that too.
>>
>>
https://github.com/matahari/matahari/wiki/Kerberos-Setup
>
> The page looks good. Nice work.
>
> On a related note, we need to be thinking about where we want to go
> with our documentation long term. We have a docbook based manual
> that has been started. I like the idea of expanding the scope of the
> docbook manual to be for all users of Matahari, whether that's the
> QMF APIs, DBus APIs, or the C/C++ APIs for writing custom agents. If
> we go that route, this documentation, among other things, would
> belong there.
>
I agree, I think my intention was to have these wiki pages as our
"drafting" area and then move that information over into the developers
manual. What do you guys think?
Sounds good, as long as you don't spend a ton of work on markup in the
wiki. If it's going to get moved anyway at some point, that work will
have to be redone for docbook.
Btw, for docbook editing, I use a gui called xmlmind. Just FYI in case
anyone else editing docbook finds it helpful.
http://www.xmlmind.com/xmleditor/download.shtml
--
Russell Bryant