As well as with Tryton ERP, I’ve been working with GNU Health which uses the Tryton framework as one of its components. It’s an amazing Tryton based project, I can’t find words to express how glad I am with it. Better than GNU Health, it’s just the Tryton project itself lol
I’d like to recommend you guys to take a look at their wiki page, specially at the way they organize the documentation and the type of documentation.
As I’m using, and administering the system in private hospitals in Angola, their wiki page is of the great help for me and the normal users.
Because I’m planning to heavily contribute to the Tryton project, I’d like to ask you guys what you think about their wiki page and do the same for Tryton. Or if you’ve already figured out the best way to start writing Tryton documentation, let me know something so I can start writing some material as a proposal.
As I was reading the topics regarding writing Tryton documentation in here, I realize that the chosen platform to write the documentation will be here. Am I right? If yes, how can I start contributing? Am I required to have a minimum level of trust? In the beginning I’m just planning to write User Tutorials.
Yeah. For example, in this section I could install GNU Health completely, and although Tryton ERP can be installed easily with $ pip install tryton, this is the kind of documentation that users and system administration can much appreciate because after we follow all the steps we have the system ready to work. As it can happen with some module, for example GNU Health Laboratory Management System.
This is how I could start understanting how powerful Tryton can be. It is an incredible tool to manage any kind of resource. And then, after all that, it’s free.
In here, we have an explanation of the core modules that makes up GNU Health. And after this, they continue to explain the best practices to have the best working system. For example, they advise users to add people before adding patients. What this simply means is that we should add a party and then create a patient from the party previously added.
I’m unable to post on the HowTo’s section.
I think we need a way to have a guide to write the user documentation. A kind of roadmap. If you see the GNU Health wiki book, not all of the section are complete or even started, but nevertheless they have the topic there so anybody who wants to write on the topic, can write the documentation and post it. In this way we can see what is missing and need work, and what is done and needs improvement.
For example, in the User Tutorial we could create just the topics we think are relevant to have a good documentation for the best user experience. And then, with time we could fill all the topics with user documentation.
Just to have it mentioned here as well:
I tried - as good as I can - to record my steps to introduce tryton, with the intention to make that useable for other beginners. Here you find the result linked. It’s of course very much work in progress and as faulty as a beginner’s work naturally is. But any help is welcome to improve the piece and some day get it ready for publication.
My motivation to do this is:
better remember my own steps, as I forget so many of already achieved skills,
reflect the setup process more thoroughly and come to better solutions,
Just my 2 cents about languages of the docs. Since our primary challenge is the lack of docs, I would encourage to make docs, videos and anything in any language convenient for an author. I mean a language should not be a requirement limiting potential authors. Translating into English will be an easy task compared to creating a doc in any language.
If necessary, I can translate into English from French and Spanish.
Who ever prepare this all documentation it’s a blessed Individual very professional and very very very valuable person/team for this Community. I never see such organized document in my career. I as Individual Thank you very much!!!
Thanks for your friendly comments. I want to draw your attention to our German Tryton book, where further progress on that initial work mentioned above is greatly extended and settled by the German Gang.
It’s written in German, sorry for that. I’d be very happy if people would use deepl translater or whatever and use it to produce versions in foreign languages. We are on the way to provide structures to make this work more easy.
