Difference between revisions of "Talk:Chado Documentation Reorganization"
From GMOD
(New page: I would recommend adopting something like - http://www.djangobook.com/ for the documentation. This has the benefit of being a "single book" and also has user comments to assist where th...) |
m |
||
| Line 1: | Line 1: | ||
| + | == Alternative Formats == | ||
| + | |||
I would recommend adopting something like - | I would recommend adopting something like - | ||
| Line 4: | Line 6: | ||
for the documentation. This has the benefit of being a "single book" and also has user comments to assist where the writer missed something. The docs can then absorb the user comments over time and improve quite a bit. | for the documentation. This has the benefit of being a "single book" and also has user comments to assist where the writer missed something. The docs can then absorb the user comments over time and improve quite a bit. | ||
| + | |||
| + | ----- | ||
| + | |||
| + | [[User:Arcoleo|Arcoleo]], | ||
| + | |||
| + | I think that's a great format, but we will stick with Mediawiki (the wiki package used in the GMOD web site) for the Chado documentation for a couple of reasons. The '''main''' reason is that I don't want to support two formats/tools - one for Chado doc and one for everything else. Another is because we want users to be able to update the main documentation in true wiki style. | ||
| + | |||
| + | Thanks,<br /> | ||
| + | [[User:Clements|Dave Clements]]<br /> | ||
| + | [[GMOD Help Desk]] | ||
Revision as of 23:43, 17 April 2008
Alternative Formats
I would recommend adopting something like -
for the documentation. This has the benefit of being a "single book" and also has user comments to assist where the writer missed something. The docs can then absorb the user comments over time and improve quite a bit.
I think that's a great format, but we will stick with Mediawiki (the wiki package used in the GMOD web site) for the Chado documentation for a couple of reasons. The main reason is that I don't want to support two formats/tools - one for Chado doc and one for everything else. Another is because we want users to be able to update the main documentation in true wiki style.
Thanks,
Dave Clements
GMOD Help Desk
