# Improve end-users documentation

**URL:** <https://discuss.tryton.org/t/improve-end-users-documentation/7145>\
**Category:** Organisation\
**Created:** [April 2, 2024, 12:03am UTC](https://discuss.tryton.org/t/improve-end-users-documentation/7145 "2024-04-02T00:03:27Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![jmn](https://discuss-cdn.tryton.org/user_avatar/discuss.tryton.org/jmn/32/2904_2.png) [@jmn](https://discuss.tryton.org/u/jmn)\
**Post date:** [April 2, 2024, 12:03am UTC](https://discuss.tryton.org/t/improve-end-users-documentation/7145/1 "2024-04-02T00:03:27Z")

</div>

> [@Newsletter April 2024](https://discuss.tryton.org/t/newsletter-april-2024/7133/1):
>
> The new [`stock_product_location_place` module](https://foss.heptapod.net/tryton/tryton/-/commit/f942d3c31190c0d60bd48c2babf8597df21891bf) allows a specific place to be defined where goods are stored in their location. [You can refer to its documentation for more details](https://docs.tryton.org/latest/modules-stock-product-location-place/index.html).

Great… and thanks on behalf of all ours Tryton users!

I think the documentation is quite a bit skinny for my end-users, and I’d like to improve it… in french. 🙂

How can we contribute?

---

<div class="post-metadata">

**Author:** ![herrdeh](https://discuss-cdn.tryton.org/user_avatar/discuss.tryton.org/herrdeh/32/821_2.png) [@herrdeh](https://discuss.tryton.org/u/herrdeh)\
**Post date:** [April 2, 2024, 6:44am UTC](https://discuss.tryton.org/t/improve-end-users-documentation/7145/2 "2024-04-02T06:44:09Z")

</div>

Feel warmly invited to contribute to [Tryton community wiki](https://foss.heptapod.net/tryton-community/documentation/user-manual/-/wikis/home) - oder provide useful links to french docu at [Tryton community HOWTOS](https://foss.heptapod.net/tryton-community/documentation/user-manual/-/wikis/HOWTOS). Send me a message with your contents - or ask @htgoebel for direct access to the wiki.

Cheers,  
Wolf

---

<div class="post-metadata">

**Author:** ![jmn](https://discuss-cdn.tryton.org/user_avatar/discuss.tryton.org/jmn/32/2904_2.png) [@jmn](https://discuss.tryton.org/u/jmn)\
**Post date:** [April 2, 2024, 10:42am UTC](https://discuss.tryton.org/t/improve-end-users-documentation/7145/3 "2024-04-02T10:42:00Z")

</div>

Nice to meet you @herrdeh.

Here is the way I want to organise our software verticalisations process based onTryton core (sorry for my _non-technician words_).

I want our contributions (in the first time improving technical documentation in french and, I hope, in 10 years, with beautifuls MR accepted by the community 😉 ) to be, as much as possible, integrated in Tryton core and commons.

Does Tryton community and HOWTOS do the trick?

°J°

 ![Untitled-2024-04-02-1207](https://discuss-cdn.tryton.org/uploads/default/original/2X/7/79e92b028ed33fb575b0553161fbcc0a262a2e10.png)

---

<div class="post-metadata">

**Author:** ![ced](https://discuss-cdn.tryton.org/user_avatar/discuss.tryton.org/ced/32/1237_2.png) [@ced](https://discuss.tryton.org/u/ced)\
**Post date:** [April 2, 2024, 10:55am UTC](https://discuss.tryton.org/t/improve-end-users-documentation/7145/4 "2024-04-02T10:55:55Z")

</div>

> [@jmn](#):
>
> I think the documentation is quite a bit skinny for my end-users, and I’d like to improve it… in french. 🙂
> 
> How can we contribute?

The documentation is written via merge request following [Tryton - How to Develop](https://www.tryton.org/develop#guidelines-documentation)  
It is done in English because it is the base language. For now we do not have already the resources to complete the existing documentation so translate it is not a goal for now.

---

<div class="post-metadata">

**Author:** ![jmn](https://discuss-cdn.tryton.org/user_avatar/discuss.tryton.org/jmn/32/2904_2.png) [@jmn](https://discuss.tryton.org/u/jmn)\
**Post date:** [April 2, 2024, 3:28pm UTC](https://discuss.tryton.org/t/improve-end-users-documentation/7145/5 "2024-04-02T15:28:53Z")

</div>

> [@ced](#):
>
> The documentation is written via merge request following [Tryton - How to Develop](https://www.tryton.org/develop#guidelines-documentation)

Thanks you for the invitation as a Developer member.

Now, for example, it’s seems that a new introduced module must have a CHANGELOG.

But, here, the CHANGELOG of the [`stock_product_location_place` module](https://foss.heptapod.net/tryton/tryton/-/blob/branch/default/modules/stock_product_location_place/CHANGELOG?ref_type=heads) is empty.

Imagine, I want to improve that, “fixing” it like this (yes, I know, my MR will not be accepted 🙂 ), on the file `https://foss.heptapod.net/tryton/tryton/-/blob/branch/default/modules/stock_product_location_place/CHANGELOG `:

`+ Version 7.0.0 - 2009-07-31`  
`+ --------------------------`  
`+ * Initial release`

And, well, it’s cool: my MR is accepted!

Thus, we will have a move like this (oui, je sais, je l’exprime avec mes mots, et c’est plus subtil que ça avec les branches, les tags et tout 🙂 :

 ![Untitled-2024-04-02-1714(1)](https://discuss-cdn.tryton.org/uploads/default/original/2X/2/2704bf53bfbe0c3ec0fb38d5a0fd96bc1ac3b9c9.png)

C’est ça, si je comprends bien?

---

<div class="post-metadata">

**Author:** ![ced](https://discuss-cdn.tryton.org/user_avatar/discuss.tryton.org/ced/32/1237_2.png) [@ced](https://discuss.tryton.org/u/ced)\
**Post date:** [April 2, 2024, 3:42pm UTC](https://discuss.tryton.org/t/improve-end-users-documentation/7145/6 "2024-04-02T15:42:20Z")

</div>

> [@jmn](#):
>
> Now, for example, it’s seems that a new introduced module must have a CHANGELOG.

The changelog contains only which feature/behavior has changed since the previous release.

> [@jmn](#):
>
> But, here, the CHANGELOG of the [`stock_product_location_place` module](https://foss.heptapod.net/tryton/tryton/-/blob/branch/default/modules/stock_product_location_place/CHANGELOG?ref_type=heads) is empty.

because it is a new module without any prior release.

> [@jmn](#):
>
> And, well, it’s cool: my MR is accepted!

But it wont because it is not correct information.

> [@jmn](#):
>
> Thus, we will have a move like this

No there is no fork with heptapod. Everybody works on the same repository.

---

<div class="post-metadata">

**Author:** ![htgoebel](https://discuss-cdn.tryton.org/user_avatar/discuss.tryton.org/htgoebel/32/1256_2.png) [@htgoebel](https://discuss.tryton.org/u/htgoebel)\
**Post date:** [April 3, 2024, 10:00am UTC](https://discuss.tryton.org/t/improve-end-users-documentation/7145/7 "2024-04-03T10:00:11Z")

</div>

> [@ced](#):
>
> > [@jmn](#):
> >
> > But, here, the CHANGELOG of the [`stock_product_location_place` module](https://foss.heptapod.net/tryton/tryton/-/blob/branch/default/modules/stock_product_location_place/CHANGELOG?ref_type=heads) is empty.
> 
> because it is a new module without any prior release.

Good practice is to state exactly this in the changelog. Thus reader can see the changelog being complete. And actually creating a new module is a change: “New module”🙂
