Well stated. Karen C
----- "Anton Chuppin" <[email protected]> wrote: > On Fri, 2009-05-15 at 08:10 -0400, Karen Schneider wrote: > > "The reason why DocBook is the tool of choice is because it gets > the > > job done and everything else is worse. > > Among all the tools that have been mentioned here, DocBook is the > only > one that was designed and built specifically for the purpose of > writing, > manipulating and publishing documentation. Everything else is either > a > multipurpose bag of tools (like Drupal) or a very general-purpose > software (like wikis). > > It seems that we are somewhat reluctant to bite the bullet and accept > DocBook as our official documentation tool on the grounds of it being > 'complex' and 'user unfriendly'. But as long as we keep in mind that > the > processes of generating content and producing documentation are > different, the 'complexity' and 'stiff learning curve' argument > should > not matter. > > The community can generate the documentation content in any tool as > long > as the output can be easily converted into plain text. Only at the > stage > of the official documentation production DocBook will become the tool > of > choice. > > Anton > > _______________________________________________ > OPEN-ILS-DOCUMENTATION mailing list > [email protected] > http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation -- Karen Collier Public Services Librarian Kent County Public Library 408 High Street Chestertown, MD 21620 410-778-3636 _______________________________________________ OPEN-ILS-DOCUMENTATION mailing list [email protected] http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation
