# Communication - documentation

**URL:** https://discuss.tryton.org/t/communication-documentation/4598
**Category:** Communication
**Created:** [September 7, 2021, 9:34am UTC](https://discuss.tryton.org/t/communication-documentation/4598 "2021-09-07T09:34:31Z")
**Posts on this page:** 6
**Page:** 1

<div class="post-metadata">

### Author: ![Delphine2776](https://discuss-cdn.tryton.org/user_avatar/discuss.tryton.org/delphine2776/32/1569_2.png) [@Delphine2776](https://discuss.tryton.org/u/Delphine2776)
#### Post date: [September 7, 2021, 9:34am UTC](https://discuss.tryton.org/t/communication-documentation/4598/1 "2021-09-07T09:34:31Z")

</div>

First of all, congratulations on all the work around Tryton.  
I would like contribute to promote this soluce and this community.  
I place a lot of importance on communication and documentation to attract customers and talent to use this solution; for proof of concept Symfony success story.  
I can explain to myself the success of symfony by a documentation which allowed me to integrate the adventure by allowing me to integrate its concepts step by step, with a cockbook kind of use case  
so  
I wonder if it would be technically possible to offer multilingual documentation and as Tryton is a management tool that would be organized as follows:

- for attract lead: first: documentation for users with use cases. I am interested in participating with this documentary aspect
- for attract talent: second: documentation for developers with the following paragraphs:  
light description of the architecture and role of each project  
cookbook to install\> develop a module from a to z  
as a developer who likes step-by-step learning i can be a tester of this documentation
- third: adminsys or ops

thank a lot

---

<div class="post-metadata">

### Author: ![pokoli](https://discuss-cdn.tryton.org/user_avatar/discuss.tryton.org/pokoli/32/22_2.png) [@pokoli](https://discuss.tryton.org/u/pokoli)
#### Post date: [September 7, 2021, 9:57am UTC](https://discuss.tryton.org/t/communication-documentation/4598/2 "2021-09-07T09:57:39Z")

</div>

Hi Delphine,

Thank your for such nice word about Tryton 🥰 We cleabrat your wish to be part of our community, specially in the documentation side which is something that we need to improve for sure.

> [@Delphine2776](#):
>
> offer multilingual documentation and as Tryton

I think we need first on having a good documenation in English and latter start thinking on translating it to other languages.

> [@Delphine2776](#):
>
> for attract lead: first: documentation for users with use cases. I am interested in participating with this documentary aspect

We have [success stories](https://www.tryton.org/success-stories) for now. Is that what are you talking about or something diferent?  
BTW: Anyone can contribute a success story 😉

> [@Delphine2776](#):
>
> cookbook to install\> develop a module from a to z

There is a [developer tutorial in progress](https://codereview.tryton.org/32711002/). Honestly, I will like to continue working on it but there are some desing choises to be decided before going further.

Last but not least, we have a [how to category](https://discuss.tryton.org/c/howto/30) where we try to document most comment process for users, developers or even sysadmins. A trust level of 2 is required to post directly there, but it is possible to anyone to contribute a [draft howto](https://discuss.tryton.org/c/howto/30) which will be reviewed and posted once agreed.

---

<div class="post-metadata">

### Author: ![Delphine2776](https://discuss-cdn.tryton.org/user_avatar/discuss.tryton.org/delphine2776/32/1569_2.png) [@Delphine2776](https://discuss.tryton.org/u/Delphine2776)
#### Post date: [September 7, 2021, 10:17am UTC](https://discuss.tryton.org/t/communication-documentation/4598/3 "2021-09-07T10:17:59Z")

</div>

> [@pokoli](#):
>
> I think we need first on having a good documenation in English and latter start thinking on translating it to other languages.

Why? it seems to me that there are solutions that automatically transforms? the best is the enemy of the good, isn’t it 🙂?

> [@pokoli](#):
>
> We have [success stories](https://www.tryton.org/success-stories) for now. Is that what are you talking about or something diferent?  
> BTW: Anyone can contribute a success story 😉

I expressed myself poorly, I was thinking more about the generic description of use cases

> [@pokoli](#):
>
> There is a [developer tutorial in progress](https://codereview.tryton.org/32711002/). Honestly, I will like to continue working on it but there are some desing choises to be decided before going further.

Thank, i will watch.  
i’m not quite comfortable with mercurial yet how can i get the patches so i can read the documentation?

---

<div class="post-metadata">

### Author: ![pokoli](https://discuss-cdn.tryton.org/user_avatar/discuss.tryton.org/pokoli/32/22_2.png) [@pokoli](https://discuss.tryton.org/u/pokoli)
#### Post date: [September 7, 2021, 10:38am UTC](https://discuss.tryton.org/t/communication-documentation/4598/4 "2021-09-07T10:38:42Z")

</div>

> [@Delphine2776](#):
>
> it seems to me that there are solutions that automatically transforms?

I tought you were talking about manually translating.  
I’m not very fan of automatic translations but anyone can activate them online. So we do not need to take care of that.

> [@Delphine2776](#):
>
> generic description of use cases

Probably this will be part of the how-to documentation already comented.

> [@Delphine2776](#):
>
> i’m not quite comfortable with mercurial yet

We have a [git mirror on github](https://github.com/tryton) but as tryton is composed on several repositories I will recomend using mercurial which will make it easier to get all the source code.

> [@Delphine2776](#):
>
> how can i get the patches so i can read the documentation

You will need first to get the source code. This is explained [on our website](https://www.tryton.org/develop).

Then you just need to download the raw patch using the [Download as RAW](https://codereview.tryton.org/download/issue32711002_369541002.diff) link of the codereview.

Once downloaded you can apply it using `patch` or `hg import --no-commit`

I usally use:

`curl https://codereview.tryton.org/download/issue32711002_369541002.diff | patch -p1`

To apply a patch in a single line. You just need to update the URL to the proper RAW url.

---

<div class="post-metadata">

### Author: ![Delphine2776](https://discuss-cdn.tryton.org/user_avatar/discuss.tryton.org/delphine2776/32/1569_2.png) [@Delphine2776](https://discuss.tryton.org/u/Delphine2776)
#### Post date: [September 7, 2021, 10:51am UTC](https://discuss.tryton.org/t/communication-documentation/4598/5 "2021-09-07T10:51:11Z")

</div>

> [@pokoli](#):
>
> I tought you were talking about manually translating.  
> I’m not very fan of automatic translations but anyone can activate them online. So we do not need to take care of that.

I first thought of the manual, but while waiting for an automatic translation seems to me a first step ?. From my point of view, not all Internet users have in mind the possibility of using an online translation tool and in terms of user experience, I think it would be more comfortable

---

<div class="post-metadata">

### Author: ![pokoli](https://discuss-cdn.tryton.org/user_avatar/discuss.tryton.org/pokoli/32/22_2.png) [@pokoli](https://discuss.tryton.org/u/pokoli)
#### Post date: [September 7, 2021, 11:16am UTC](https://discuss.tryton.org/t/communication-documentation/4598/6 "2021-09-07T11:16:24Z")

</div>

I will prefer to no start bulding the house from the roof. We need first to have the proper documentation (we are still missing a lot of modules). Once we get there, we can start thinking in translations.
