Quite lost how to contribute

[Jean-Michel Pouré]

Dear all,

First, I would like to congratulate you for the hard work around Tryton.

Tryton seems a nice alternative to OpenERP/Odoo and I am willing to contribute.

But frankly, I am quite lost and need some advice.

First, I am looking for documentation:
http://doc.tryton.org/4.8/
https://github.com/tryton/trytond/blob/develop/INSTALL
https://trytond.readthedocs.io/en/latest/

What is the main documentation and how to contribute to it?

Secondly, I am quite lost how to install Tryton latest version.

Again, there are several sources. Tryton is available on Github. It is only when visiting http://www.tryton.org/download.html that I understand hg should be used. But downloading modules is not documented.

Lastly, when trying to use web client, I don't understand whether it is Werkzeug or SAO and how to install it.

My personal point of view is that a lot of energy is being lost between several "entry points". At this point of development, maybe Tryton needs a single board system and a single repository and a single documentation system, but this is just a beginner thought.

I am willing to write some documentation if guide me. An example documentation I have written: https://github.com/ffries/Debian-installer-with-serial-console

Please tell me how to update documentation and we can use this thread to update the installation documentation and make it more simple.

Thanks!

[Sergi Almacellas Abellana]

El 18/05/18 a les 10:25, Jean-Michel Pouré ha escrit:

> Dear all,
>
> First, I would like to congratulate you for the hard work around Tryton.
>
> Tryton seems a nice alternative to OpenERP/Odoo and I am willing to contribute.

Welcome aboard,

>
> But frankly, I am quite lost and need some advice.
>
> First, I am looking for documentation:
> http://doc.tryton.org/4.8/
> https://github.com/tryton/trytond/blob/develop/INSTALL
> https://trytond.readthedocs.io/en/latest/
>
> What is the main documentation and how to contribute to it?

The main documentation is http://doc.tryton.org

>
> Secondly, I am quite lost how to install Tryton latest version.

What do you undestand by latest version? Stable version or development
version.

Stable version can be installed with pip or with packages from your
distrubtion. But normally distributions does not contain the latest
version so pip is (for me) the best option.

>
> Again, there are several sources. Tryton is available on Github. It is only when visiting http://www.tryton.org/download.html that I understand hg should be used. But downloading modules is not documented.

We have mirrors on github and on bitbucket, but main development happens
on our mercurial repositories that are hosted on hg.tryton.org

We have on repository for each component: trytond (the server). tryton
(the desktop client), sao (the webclient) and one for each module (You
can see them on hg.tryton.org/modules)

>
> Lastly, when trying to use web client, I don't understand whether it is Werkzeug or SAO and how to install it.

The webclient is sao. You can install it from npm if you want:

https://www.npmjs.com/package/tryton-sao

>
> My personal point of view is that a lot of energy is being lost between several "entry points". At this point of development, maybe Tryton needs a single board system and a single repository and a single documentation system, but this is just a beginner thought.>
> I am willing to write some documentation if guide me. An example documentation I have written: https://github.com/ffries/Debian-installer-with-serial-console

That will be great, we miss some documentation for sure.

>
> Please tell me how to update documentation and we can use this thread to update the installation documentation and make it more simple.

You should propose a patch to the doc folder of the trytond server. Here
is our how to contribute:

http://www.tryton.org/how-to-contribute.html

We are normally online on the #tryton chanell on freenode. So feel free
to ask there if you have simplier doubts.

--
Sergi Almacellas Abellana
www.koolpi.com
Twitter: @pokoli_srk

[Jean-Michel Pouré]

Thank you for your welcome. I will be using IRC to ask questions and then submit and discuss patches. Kind regards, Jean-Michel Pouré

[Dominique Chabord]

2018-05-18 10:25 GMT+02:00 Jean-Michel Pouré <jmp...@gmail.com>:

>
> First, I am looking for documentation:
> http://doc.tryton.org/4.8/

Everything you need should be there. If not, it must be completed

>
> What is the main documentation and how to contribute to it?

http://doc.tryton.org/4.8/

>
> Secondly, I am quite lost how to install Tryton latest version.
>
> Again, there are several sources.

tryton.org should be enough.

> Tryton is available on Github.
> It is only when visiting http://www.tryton.org/download.html that I understand hg should be used. But downloading modules is not documented.

There are several possibilities

hg is the way to go to preserve history and get on-going development.
Personnally, I don't like forking a work in progress server to a
production server
hg nested extension allows to get both server and modules.

You can also use distributions on pip, which are perfectly maintained

Another possibility is to download from tryton.org. Today my hosting
service uses :
wget -r -np -nd --no-check-certificate -Atrytond-*.tar.gz
https://downloads.tryton.org/4.8/
wget -r -np -nd --no-check-certificate -Atrytond_*.tar.gz
https://downloads.tryton.org/4.8/

care: trytond-* for the server trytond_* for the modules

>
> Lastly, when trying to use web client, I don't understand whether it is Werkzeug or SAO and how to install it.
>
> My personal point of view is that a lot of energy is being lost between several "entry points".

You cannot prevent other people to replicate to mirrors because they
are familiar with alternative services.

> At this point of development, maybe Tryton needs a single board system and a single repository and a single documentation system, but this is just a beginner thought.

It is tryton.org
Tryton is particularly consistent, in particular comparing with other
projects you know.
In order to get a single doc, we have to provide it in english only,
which is a problem for many.
Also we tend to discourage howtos, which usually refer to a specific
use, are partial and not maintained, often even not caring about
common good practices.

>
> I am willing to write some documentation if guide me. An example documentation I have written: https://github.com/ffries/Debian-installer-with-serial-console
>
> Please tell me how to update documentation and we can use this thread to update the installation documentation and make it more simple.

It will be difficult to get it simpler, but we can make it more
verbose for beginners.
Nevertheless,Tryton doc should improve but stay very focussed, and
we'd rather consider litterature "about Tryton", separated from
official documentation, to help different audiences in different
languages.