That is awesomely amazing. Looking forward to working with it. I am increasingly of the opinion that you don't sleep / are superhuman and it scares me slightly ; )
On Fri, Sep 24, 2010 at 6:19 PM, Monty Taylor <[email protected]> wrote: > On 09/24/2010 01:18 PM, Brian Aker wrote: > > Hi! > > > > So the wiki really doesn't seem to be working for documentation. It lacks > comments, which are super useful, and it is just one big long list. > > > > A few thoughts: > > 1) Docbook sucks to write in. > > 2) I personally would be far more inclined to write via bzr (and have it > shipped with the code). > > 3) Doxygen is not for user level documentation. > > > > I've had a couple of folks who have been willing to work on this, but the > above pretty much means nothings happens. If I start writing on this it will > be POD (human editable, has tools, etc...). YAML would be fine as well, but > the layout for it is sort of odd. > > > > None of this solves the comment problem. PG's documentation seems ok, as > does MySQL's. > > As a follow up, I should add that the documentation entry point is > docs/index.rst - and that you should assume Sphinx 1.0 when writing docs. > > _______________________________________________ > Mailing list: > https://launchpad.net/~drizzle-discuss<https://launchpad.net/%7Edrizzle-discuss> > Post to : [email protected] > Unsubscribe : > https://launchpad.net/~drizzle-discuss<https://launchpad.net/%7Edrizzle-discuss> > More help : https://help.launchpad.net/ListHelp >
_______________________________________________ Mailing list: https://launchpad.net/~drizzle-discuss Post to : [email protected] Unsubscribe : https://launchpad.net/~drizzle-discuss More help : https://help.launchpad.net/ListHelp
