# GSoD Status update

**URL:** https://discuss.tryton.org/t/gsod-status-update/3406
**Category:** Communication
**Created:** [October 28, 2020, 6:18pm UTC](https://discuss.tryton.org/t/gsod-status-update/3406 "2020-10-28T18:18:05Z")
**Posts on this page:** 12
**Page:** 1

<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: [October 28, 2020, 6:18pm UTC](https://discuss.tryton.org/t/gsod-status-update/3406/1 "2020-10-28T18:18:06Z")

</div>

I want to provide and update of the [GSoD Project - Documentation for Basic Modules](https://discuss.tryton.org/t/gsod-project-documentation-for-basic-modules/3186). Today we (me and @timitos) had a videochat with @dave where he explained to us what the work he has done and how everything is structured.

After seen the result I have to congratulate dave for the amazing work. We have a very well structured base where we document the usage of the application but also how is designed.

At the current state we need to review all the documentation. I will like to focus specially on the usage part (where the users can find how to perform some actions). So if you are and end user it’s your time to contribute to the project. It will be great if you can review the usage parts of the reviews (the original topic has the link to the issues and reviews) and let us know which parts are you still missing. I’m going to leave my comments there but as Tryton user for some years I may miss some important parts.

If you are a Tryton implementator it be great if you can list use the most common problems that your users find, so we can include some text on the documentation to prevent them.

I has been great to talk with other community members, so I will like you to share a photo of our videochat:

 ![GSOC_meeting_participants](https://discuss-cdn.tryton.org/uploads/default/original/2X/4/46cf570299a616f1c88e443a5813b3f9da333396.jpeg)

 ![GSOC_meeting](https://discuss-cdn.tryton.org/uploads/default/original/2X/7/7375828972be050c9e7c0894b97d3dfa87ea0f57.jpeg)

---

<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: [October 28, 2020, 10:52pm UTC](https://discuss.tryton.org/t/gsod-status-update/3406/2 "2020-10-28T22:52:50Z")

</div>

I will try to review them after the release 5.8. I think it is not a problem to have the documentation after the release because it will be anyway available on [https://docs.tryton.org/](https://docs.tryton.org/).  
But my initial feeling from what I already saw looks very promising.  
Great work! 👏

---

<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: [October 29, 2020, 8:08am UTC](https://discuss.tryton.org/t/gsod-status-update/3406/3 "2020-10-29T08:08:33Z")

</div>

> [@ced](#):
>
> I will try to review them after the release 5.8. I think it is not a problem to have the documentation after the release because it will be anyway available on [https://docs.tryton.org/](https://docs.tryton.org/).

I agree this is not a problem. On the conference we agreed that it will be good to have a result for the 6.0 release.  
As shown on the [seasson of docs timeline](https://developers.google.com/season-of-docs/docs/timeline) the program ends on the 5th of December so it will be great to have as much feedback as possible before this date.

---

<div class="post-metadata">

### Author: ![edbo](https://discuss-cdn.tryton.org/letter_avatar_proxy/v4/letter/e/f14d63/32.png) [@edbo](https://discuss.tryton.org/u/edbo)
#### Post date: [October 29, 2020, 9:49am UTC](https://discuss.tryton.org/t/gsod-status-update/3406/4 "2020-10-29T09:49:23Z")

</div>

Personally I find it hard to read in the review tool because there are links to other parts of the documentation. Is there a possibility to render them to the right format like [docs.tryton.org](http://docs.tryton.org) and put it somewhere on the internet or as downloadable HTML pages?

---

<div class="post-metadata">

### Author: ![dave](https://discuss-cdn.tryton.org/letter_avatar_proxy/v4/letter/d/ee7513/32.png) [@dave](https://discuss.tryton.org/u/dave)
#### Post date: [October 29, 2020, 10:07am UTC](https://discuss.tryton.org/t/gsod-status-update/3406/5 "2020-10-29T10:07:20Z")

</div>

I don’t think it would be too difficult for me to setup a separate “testing” version of the documentation on readthedocs.

I think it would be a good thing if it makes it more likely that people will provide feedback. Another advantage would be that we could see exactly what the documentation would look like, and how it is formatted. Also we would be able to double check that the markup works and gets displayed correctly.

Once the improvements are committed we could then take down the “testing” version.

What do you think?

---

<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: [October 29, 2020, 10:17am UTC](https://discuss.tryton.org/t/gsod-status-update/3406/6 "2020-10-29T10:17:39Z")

</div>

If you want to put effort in such thing, you can do it. I do not think it requires anything from \*.tryton.org, you can setup a code mirror, push you changes there and trigger a readthedocs build with your personal account.

---

<div class="post-metadata">

### Author: ![edbo](https://discuss-cdn.tryton.org/letter_avatar_proxy/v4/letter/e/f14d63/32.png) [@edbo](https://discuss.tryton.org/u/edbo)
#### Post date: [October 29, 2020, 10:27am UTC](https://discuss.tryton.org/t/gsod-status-update/3406/7 "2020-10-29T10:27:21Z")

</div>

I really think it’s great idea to do 👍. To make a bit more noise, create a `sticky` topic here with a link to the documentation so it won’t be lost.

To push the current users on the forum here, send them all an email to review the new documentation 🤔

---

<div class="post-metadata">

### Author: ![dave](https://discuss-cdn.tryton.org/letter_avatar_proxy/v4/letter/d/ee7513/32.png) [@dave](https://discuss.tryton.org/u/dave)
#### Post date: [October 29, 2020, 1:41pm UTC](https://discuss.tryton.org/t/gsod-status-update/3406/8 "2020-10-29T13:41:04Z")

</div>

> [@edbo](#):
>
> I really think it’s great idea to do 👍.

You can find it using this post [GSoD Preview of Module Documentation](https://discuss.tryton.org/t/gsod-preview-of-module-documentation/3408).

> [@edbo](#):
>
> To make a bit more noise, create a `sticky` topic here with a link to the documentation so it won’t be lost.

I can’t make it sticky, perhaps if someone else thinks it is a good idea then they could?

> [@edbo](#):
>
> To push the current users on the forum here, send them all an email to review the new documentation

Although that may get more people to review the improvements, I’m a bit worried it might also annoy some people too. I personally don’t like the idea of sending people an unsolicited email and am unsure of where it would fit in with the GDPR.

---

<div class="post-metadata">

### Author: ![albert](https://discuss-cdn.tryton.org/user_avatar/discuss.tryton.org/albert/32/21_2.png) [@albert](https://discuss.tryton.org/u/albert)
#### Post date: [October 29, 2020, 2:17pm UTC](https://discuss.tryton.org/t/gsod-status-update/3406/9 "2020-10-29T14:17:40Z")

</div>

> [@dave](#):
>
> You can find it using this post [GSoD Preview of Module Documentation](https://discuss.tryton.org/t/gsod-preview-of-module-documentation/3408).

Congratulations! Great work, Dave!

---

<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: [October 29, 2020, 2:48pm UTC](https://discuss.tryton.org/t/gsod-status-update/3406/10 "2020-10-29T14:48:00Z")

</div>

> [@dave](#):
>
> > [@edbo](#):
> >
> > To push the current users on the forum here, send them all an email to review the new documentation
> 
> Although that may get more people to review the improvements, I’m a bit worried it might also annoy some people too. I personally don’t like the idea of sending people an unsolicited email and am unsure of where it would fit in with the GDPR.

I agree with dave here. We should not send the users an email but just let the users see this post and review the docs.

Feel free to share the link with more people to give it more visiblitiy.

---

<div class="post-metadata">

### Author: ![edbo](https://discuss-cdn.tryton.org/letter_avatar_proxy/v4/letter/e/f14d63/32.png) [@edbo](https://discuss.tryton.org/u/edbo)
#### Post date: [October 29, 2020, 6:59pm UTC](https://discuss.tryton.org/t/gsod-status-update/3406/11 "2020-10-29T18:59:10Z")

</div>

> [@pokoli](#):
>
> I agree with dave here. We should not send the users an email …

It was kind of a joke 😄. Personally I also don’t want that kind of email. But I’m still behind the possibility to make the topic sticky so it won’t get lost in the rest of the topics.

---

<div class="post-metadata">

### Author: ![dave](https://discuss-cdn.tryton.org/letter_avatar_proxy/v4/letter/d/ee7513/32.png) [@dave](https://discuss.tryton.org/u/dave)
#### Post date: [October 30, 2020, 10:47am UTC](https://discuss.tryton.org/t/gsod-status-update/3406/12 "2020-10-30T10:47:11Z")

</div>

> [@edbo](#):
>
> It was kind of a joke 😄.

Sorry, I must have misread it and took it seriously! Let’s not start a war over this!
