On 16 Feb 05:46, M. Murray wrote: > > I don't see the point to duplicate the documentation, except having once > > again (like in the wiki) out dated and not maintained data. > > The only up to date and maintained information is the documentation. > > > > > One point is for clarity. Another point is for completeness. That Debian > ships their packages with enough boilerplate and documentation to allow a > user to get going right away seems to be lost on you.
Of course the trytond documentation can be improved and patch is welcomed. But I still think it is bad to ship a kind of default configuration. Tryton doesn't need it and in the future it will even need more than one configuration file. It is much more better to get the user understand the configuration process by looking at the documenation because we will have more and more configuration options in the furture added by each module and so it will be impossible to get them documented correctly in one single documentation without talking about external modules on which Tryton has no control. > If the Debian package > told me to > visit http://doc.tryton.org/3.4/trytond/doc/topics/configuration.html > before I could configure the package I just installed I would not be > pleased. Of course, it should not tell you that but it should tell you to look at /usr/share/doc/trytond-*/topics/configuration.html > I won't even bother to mention the LDAP connection part at the bottom of > that config file. And like the OP requested, an example can be quite > useful. This is described in the documentation of the ldap_authentication module which point you to the RFC-2255 which contains a lot of example. -- Cédric Krier - B2CK SPRL Email/Jabber: [email protected] Tel: +32 472 54 46 59 Website: http://www.b2ck.com/
