Message Threads | The Odoo Community Association

Re: update to the odoo community module shop

Hello Alexandre,

A huge thank you for taking care of this issue and fixing it!

I wish everyone a nice weekend!

Virginie Dewulf

Executive Director

Odoo Community Association (OCA)

+32 477 64 17 20

Le ven. 17 mai 2024 à 00:47, Alexandre Fayolle <notifications@odoo-community.org> a écrit :

On 16/05/2024 10:16, Yoshi Tashiro wrote:

> OCA shop has been out of sync for about a year now if I understand the 

> situation correctly. I've seen people, including myself, comment on this 

> occasionally. Is this something tricky to fix?

Thanks for the heads up. I gave a shot at this and rewrote the scheduled 
actions that are synchronizing the repository branches and analyzing the 
code. They were processing things in a daily cron processing all the 
repositories and branches in 1 go, which was a sure way to get a timeout 
or a rollback.

I switched to a cron running every 10min and processing the 10 oldest 
branches. With the current number of project branches, this means that 
it should take about 1.5 day to process everything, without causing a 
huge load on the server (and then the branch scanning will restart from 
the beginning), so the average delay between a merge and the 
availability of the module on the "OCA shop" should be less than 1d.

I'll keep an eye on the progress in the upcoming days, to see if maybe 
one repo / branch is causing issues.

Stay tuned.

-- 
Alexandre Fayolle
Senior Software Engineer
Tel : +33 4 58 48 20 30

Camptocamp France SAS
18 rue du Lac Saint André
73 370 Le Bourget-du-Lac
France

http://www.camptocamp.com

_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe

by Virginie Dewulf - 11:47 - 17 May 2024

update to the odoo community module shop

On 16/05/2024 10:16, Yoshi Tashiro wrote:

> OCA shop has been out of sync for about a year now if I understand the 

> situation correctly. I've seen people, including myself, comment on this 

> occasionally. Is this something tricky to fix?

Thanks for the heads up. I gave a shot at this and rewrote the scheduled 
actions that are synchronizing the repository branches and analyzing the 
code. They were processing things in a daily cron processing all the 
repositories and branches in 1 go, which was a sure way to get a timeout 
or a rollback.

I switched to a cron running every 10min and processing the 10 oldest 
branches. With the current number of project branches, this means that 
it should take about 1.5 day to process everything, without causing a 
huge load on the server (and then the branch scanning will restart from 
the beginning), so the average delay between a merge and the 
availability of the module on the "OCA shop" should be less than 1d.

I'll keep an eye on the progress in the upcoming days, to see if maybe 
one repo / branch is causing issues.

Stay tuned.

-- 
Alexandre Fayolle
Senior Software Engineer
Tel : +33 4 58 48 20 30

Camptocamp France SAS
18 rue du Lac Saint André
73 370 Le Bourget-du-Lac
France

http://www.camptocamp.com

by Alexandre Fayolle - 12:47 - 17 May 2024

Re: CI and oca_dependencies.txt

Found it: https://github.com/OCA/maintainer-quality-tools/blob/master/travis/clone_oca_dependencies

Was used for travis

Le jeu. 16 mai 2024 à 12:02, Yann Papouin <ypa@decgroupe.com> a écrit :

Hello,

I'm trying to recreate a CI environment for testing our modules on our GitLab instance.
In the documentation [1], it is stated that we could use a custom repo URL and branch using oca_dependencies.txt.
But after searching in oca-ci repo [2] and test.yml in modules repositories, I don't find any use of the oca_dependencies.txt.
Am I missing something or all dependencies are only managed by setuptools-odoo and installed via pip instead of cloning modules repositories ?

If oca_dependencies.txt is no longer supported, do you remember where this file was parsed and processed ?

[1] https://github.com/OCA/odoo-community.org/blob/master/website/Contribution/CONTRIBUTING.rst#oca_dependencies-txt
[2] https://github.com/OCA/oca-ci

Best regards,
Yann Papouin.

by Yann Papouin - 04:37 - 16 May 2024

Re: CI and oca_dependencies.txt

Hello Yann,

Indeed oca_dependencies.txt is not used anymore by the OCA CI.

This file was used by https://github.com/OCA/maintainer-quality-tools.

It is most likely not maintained at all in recent (>=14.0) branches OCA repos, so I think we should now remove mentions of it from our documentation.

-sbi

On Thu, May 16, 2024 at 12:07 PM Yann Papouin <notifications@odoo-community.org> wrote:

Hello,

I'm trying to recreate a CI environment for testing our modules on our GitLab instance.
In the documentation [1], it is stated that we could use a custom repo URL and branch using oca_dependencies.txt.
But after searching in oca-ci repo [2] and test.yml in modules repositories, I don't find any use of the oca_dependencies.txt.
Am I missing something or all dependencies are only managed by setuptools-odoo and installed via pip instead of cloning modules repositories ?

If oca_dependencies.txt is no longer supported, do you remember where this file was parsed and processed ?

[1] https://github.com/OCA/odoo-community.org/blob/master/website/Contribution/CONTRIBUTING.rst#oca_dependencies-txt
[2] https://github.com/OCA/oca-ci

Best regards,
Yann Papouin.

_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe

by Stéphane Bidoul - 04:37 - 16 May 2024

CI and oca_dependencies.txt

Hello,

I'm trying to recreate a CI environment for testing our modules on our GitLab instance.

In the documentation [1], it is stated that we could use a custom repo URL and branch using oca_dependencies.txt.

But after searching in oca-ci repo [2] and test.yml in modules repositories, I don't find any use of the oca_dependencies.txt.

Am I missing something or all dependencies are only managed by setuptools-odoo and installed via pip instead of cloning modules repositories ?

If oca_dependencies.txt is no longer supported, do you remember where this file was parsed and processed ?

[1] https://github.com/OCA/odoo-community.org/blob/master/website/Contribution/CONTRIBUTING.rst#oca_dependencies-txt

[2] https://github.com/OCA/oca-ci

Best regards,

Yann Papouin.

by Yann Papouin - 12:06 - 16 May 2024

Re: server-tools pull request help

Hi,

Many of the commercial modules in de odoo app store make it more into a crap store. Nevertheless, my experience with googling for modules is that I often find our nice OCA modules, through this very app store. So I think it is definitely useful to push them there. Would certainly be nice if that proces could be automated some way.

Kind regards, Ronald

On 16-05-2024 10:07, Janik von Rotz wrote:

Hi Daniel,

I guess the Odoo app store is good for exposure/discovery, but not much more.

> It requires manual labor to add the new branches for each of the hundreds of repositories each year.

By this you mean the repo/branch registration in the app.odoo.com dashboard? Could it be automated?

> In my opinion, the right place to look for OCA modules is our index:

I agree. We have to make sure it is well known and delivers apps of better quality than the Odoo app store.

Cheers, Janik

On 5/16/24 09:21, Daniel Reis wrote:
Probably the Odoo app store didn't have time to do the repo sync.
To be sure, I forced it and it is published now.

Since we're here, I'm not sure we want to continue publishing OCA modules to the app store.
It requires manual labor to add the new branches for each of the hundreds of repositories each year.
It is also incomplete as there are sync problems.
For example, the app store does not support a module that has moved between repos.

In my opinion, we the right place to look for OCA modules is our index:
https://odoo-community.org/shop

My 2 cents.

Thanks
Daniel

On 16/05/2024 07:37, luka zorko wrote:
Thank you so much for helping me merge the pull request.
I only have one more question considering this module - what needs to be 
done for the version 17.0 to be visible in the odoo app store ?
Here is the URL where only versions up to 16.0 are visible: 
https://apps.odoo.com/apps/modules/16.0/iap_alternative_provider/
--

DANIEL REIS
MANAGING PARTNER
Meet with me.
M: +351 919 991 307
E: dreis@OpenSourceIntegrators.com
A: Avenida da República 3000, Estoril Office Center, 2649-517 Cascais
_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe
-- 
We are hiring: https://www.mint-system.ch/jobs
Send application to: jobs@mint-system.ch

CTO Mint System GmbH 
Tel: +41 44 244 7222
_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe

by "Ronald Portier" <rportier@therp.nl> - 11:10 - 16 May 2024

Re: server-tools pull request help

> > In my opinion, the right place to look for OCA modules is our index:
>
> I agree. We have to make sure it is well known and delivers apps of better quality than the Odoo app store.

OCA shop has been out of sync for about a year now if I understand the situation correctly. I've seen people, including myself, comment on this occasionally. Is this something tricky to fix?

--

Yoshi Tashiro

Quartile Limited

On Thu, May 16, 2024 at 5:07 PM Janik von Rotz <notifications@odoo-community.org> wrote:

Hi Daniel,

I guess the Odoo app store is good for exposure/discovery, but not much more.

> It requires manual labor to add the new branches for each of the hundreds of repositories each year.

By this you mean the repo/branch registration in the app.odoo.com dashboard? Could it be automated?

> In my opinion, the right place to look for OCA modules is our index:

I agree. We have to make sure it is well known and delivers apps of better quality than the Odoo app store.

Cheers, Janik

On 5/16/24 09:21, Daniel Reis wrote:
Probably the Odoo app store didn't have time to do the repo sync.
To be sure, I forced it and it is published now.

Since we're here, I'm not sure we want to continue publishing OCA modules to the app store.
It requires manual labor to add the new branches for each of the hundreds of repositories each year.
It is also incomplete as there are sync problems.
For example, the app store does not support a module that has moved between repos.

In my opinion, we the right place to look for OCA modules is our index:
https://odoo-community.org/shop

My 2 cents.

Thanks
Daniel

On 16/05/2024 07:37, luka zorko wrote:
Thank you so much for helping me merge the pull request.
I only have one more question considering this module - what needs to be 
done for the version 17.0 to be visible in the odoo app store ?
Here is the URL where only versions up to 16.0 are visible: 
https://apps.odoo.com/apps/modules/16.0/iap_alternative_provider/
--

DANIEL REIS
MANAGING PARTNER
Meet with me.
M: +351 919 991 307
E: dreis@OpenSourceIntegrators.com
A: Avenida da República 3000, Estoril Office Center, 2649-517 Cascais
_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe
-- 
We are hiring: https://www.mint-system.ch/jobs
Send application to: jobs@mint-system.ch

CTO Mint System GmbH 
Tel: +41 44 244 7222
_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe

by Yoshi Tashiro. - 10:15 - 16 May 2024

Re: server-tools pull request help

Hi Daniel,

I guess the Odoo app store is good for exposure/discovery, but not much more.

> It requires manual labor to add the new branches for each of the hundreds of repositories each year.

By this you mean the repo/branch registration in the app.odoo.com dashboard? Could it be automated?

> In my opinion, the right place to look for OCA modules is our index:

I agree. We have to make sure it is well known and delivers apps of better quality than the Odoo app store.

Cheers, Janik

On 5/16/24 09:21, Daniel Reis wrote:

Probably the Odoo app store didn't have time to do the repo sync.
To be sure, I forced it and it is published now.

Since we're here, I'm not sure we want to continue publishing OCA modules to the app store.
It requires manual labor to add the new branches for each of the hundreds of repositories each year.
It is also incomplete as there are sync problems.
For example, the app store does not support a module that has moved between repos.

In my opinion, we the right place to look for OCA modules is our index:
https://odoo-community.org/shop

My 2 cents.

Thanks
Daniel

On 16/05/2024 07:37, luka zorko wrote:
Thank you so much for helping me merge the pull request.
I only have one more question considering this module - what needs to be 
done for the version 17.0 to be visible in the odoo app store ?
Here is the URL where only versions up to 16.0 are visible: 
https://apps.odoo.com/apps/modules/16.0/iap_alternative_provider/
--

DANIEL REIS
MANAGING PARTNER
Meet with me.
M: +351 919 991 307
E: dreis@OpenSourceIntegrators.com
A: Avenida da República 3000, Estoril Office Center, 2649-517 Cascais
_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe

-- 
We are hiring: https://www.mint-system.ch/jobs
Send application to: jobs@mint-system.ch

CTO Mint System GmbH 
Tel: +41 44 244 7222

by Janik von Rotz - 10:06 - 16 May 2024

Re: server-tools pull request help

Probably the Odoo app store didn't have time to do the repo sync.
To be sure, I forced it and it is published now.

Since we're here, I'm not sure we want to continue publishing OCA modules to the app store.
It requires manual labor to add the new branches for each of the hundreds of repositories each year.
It is also incomplete as there are sync problems.
For example, the app store does not support a module that has moved between repos.

In my opinion, we the right place to look for OCA modules is our index:
https://odoo-community.org/shop

My 2 cents.

Thanks
Daniel

On 16/05/2024 07:37, luka zorko wrote:

Thank you so much for helping me merge the pull request.
I only have one more question considering this module - what needs to be 
done for the version 17.0 to be visible in the odoo app store ?
Here is the URL where only versions up to 16.0 are visible: 
https://apps.odoo.com/apps/modules/16.0/iap_alternative_provider/

--

DANIEL REIS
MANAGING PARTNER

Meet with me.
M: +351 919 991 307
E: dreis@OpenSourceIntegrators.com
A: Avenida da República 3000, Estoril Office Center, 2649-517 Cascais

by Daniel Reis - 09:20 - 16 May 2024

1 attachments 1 attachments

Re: server-tools pull request help

Thank you so much for helping me merge the pull request.
I only have one more question considering this module - what needs to be 
done for the version 17.0 to be visible in the odoo app store ?
Here is the URL where only versions up to 16.0 are visible: 
https://apps.odoo.com/apps/modules/16.0/iap_alternative_provider/


On 13/05/2024 19:21, luka zorko wrote:

> The pull request received a couple of comments and it has been silent 

> for weeks now.

> Please help me get this merged by clarifying any changes you would 

> like to be made, so we can move forward.

>

> Thank you.

>

> On 23/04/2024 16:07, luka zorko wrote:

>> Dear OCA maintainers

>>

>> Could someone please check out my pull request trying to migrate 

>> iap_alternative_provider to odoo 17.

>> The module is very small and truly minor changes have been made, but 

>> a client needs this functionality for a dependent module.

>> Here is the URL of the pull request: 

>> https://github.com/OCA/server-tools/pull/2914

>>

>> Thank you for your assistance.

>> Best regards,

>> Luka Zorko

>>

>>

>>

by "luka zorko" <lukaz@guru.si> - 08:35 - 16 May 2024

Re: server-tools pull request help

Hey Luka,

I see that it's merged now; in general if you want to ask the maintainers to merge after you have gathered enough reviews, you can also do a "@OCA/tools-maintainers Merge please" message, then it will arrive at the right people.

Each OCA PSC team has its own such taggable.

-Tom

On 5/13/24 19:27, luka zorko wrote:

The pull request received a couple of comments and it has been silent 
for weeks now.
Please help me get this merged by clarifying any changes you would like 
to be made, so we can move forward.

Thank you.

On 23/04/2024 16:07, luka zorko wrote:

> Dear OCA maintainers

>

> Could someone please check out my pull request trying to migrate 

> iap_alternative_provider to odoo 17.

> The module is very small and truly minor changes have been made, but a 

> client needs this functionality for a dependent module.

> Here is the URL of the pull request: 

> https://github.com/OCA/server-tools/pull/2914

>

> Thank you for your assistance.

> Best regards,

> Luka Zorko

>

>

>

_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe

by Tom Blauwendraat - 12:06 - 14 May 2024

Re: server-tools pull request help

The pull request received a couple of comments and it has been silent 
for weeks now.
Please help me get this merged by clarifying any changes you would like 
to be made, so we can move forward.

Thank you.

On 23/04/2024 16:07, luka zorko wrote:

> Dear OCA maintainers

>

> Could someone please check out my pull request trying to migrate 

> iap_alternative_provider to odoo 17.

> The module is very small and truly minor changes have been made, but a 

> client needs this functionality for a dependent module.

> Here is the URL of the pull request: 

> https://github.com/OCA/server-tools/pull/2914

>

> Thank you for your assistance.

> Best regards,

> Luka Zorko

>

>

>

by "luka zorko" <lukaz@guru.si> - 07:26 - 13 May 2024

Re: Migration of App "Email Tracking" to Odoo Version 17

Hello Andrea

You can follow last news here

https://github.com/OCA/social/issues/1251

Best regards

--------------------------------
Cyril VINH-TUNG
INVITU
Computer & Network Engineering
BP 32 - 98713 Papeete - French Polynesia
Tél: +689 40 46 11 99
contact@invitu.com
www.invitu.com

Le jeu. 9 mai 2024, 05:01, ARXI | Andrea Almeida <notifications@odoo-community.org> a écrit :

Dears

I hope this email finds you well. I am reaching out to inquire about the migration status of the following app to Odoo Version 17:

Email tracking: https://apps.odoo.com/apps/modules/16.0/mail_tracking/

We are currently in need of this app for our new client, and it's crucial for us to have them compatible with the latest version of Odoo.

Could you please provide an update on when these apps are expected to be migrated to Odoo Version 17?

Thank you so much for you valuable help

--

Melhores Cumprimentos | Best Regards

www.arxi.pt +351 244 237 810
(chamada para a rede fixa nacional)

Esta mensagem contém informação de natureza confidencial e é exclusivamente dirigida ao(s) destinatário(s) indicado(s). Se por engano receber este e-mail agradecemos que não o copie nem o reenvie e que nos notifique do ocorrido através do email de resposta. Qualquer uso do seu conteúdo é um ato ilegal.

This message contains confidential information and is addressed exclusively to the designated addressee. If you received this email by mistake we appreciate that you do not copy or resend it and that you notify us of via the reply email. Any use of its content is strictly illegal.

_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe

by Cyril VINH-TUNG - 07:06 - 9 May 2024

Migration of App "Email Tracking" to Odoo Version 17

Dears

I hope this email finds you well. I am reaching out to inquire about the migration status of the following app to Odoo Version 17:

Email tracking: https://apps.odoo.com/apps/modules/16.0/mail_tracking/

We are currently in need of this app for our new client, and it's crucial for us to have them compatible with the latest version of Odoo.

Could you please provide an update on when these apps are expected to be migrated to Odoo Version 17?

Thank you so much for you valuable help

--

Melhores Cumprimentos | Best Regards


	www.arxi.pt		+351 244 237 810 (chamada para a rede fixa nacional)

Esta mensagem contém informação de natureza confidencial e é exclusivamente dirigida ao(s) destinatário(s) indicado(s). Se por engano receber este e-mail agradecemos que não o copie nem o reenvie e que nos notifique do ocorrido através do email de resposta. Qualquer uso do seu conteúdo é um ato ilegal.

This message contains confidential information and is addressed exclusively to the designated addressee. If you received this email by mistake we appreciate that you do not copy or resend it and that you notify us of via the reply email. Any use of its content is strictly illegal.

by Andrea Delgado - 05:00 - 9 May 2024

Free courses

Hi

We offer free online tutorials (with no subscriptions needed) on a YouTube channel with over 200,000 subscribers here:

https://www.wiseowl.co.uk/videos/

We also have full online-tutorials (again free, and with no log-in needed) in VBA and SQL:

https://www.wiseowl.co.uk/guides/

Would any of the readers of your site be interested in either of these ideas?

Regards

Andy (Brown)

Telephone: +44 (0) 161 883 3606
Website: https://www.wiseowl.co.uk

Follow us:

by "Andy Brown" <andy.brown@wiseowl.co.uk> - 05:16 - 8 May 2024

4 attachments 4 attachments

Mabe addenda for Mexican Localization

Hello!

We would like to know if anyone in the community has any module or development for the addenda for Mabe. Please reach out to us if you do

Thank you!

--

SAMUEL MACIAS OROPEZA

TECH LEAD

smacias@opensourceintegrators.com

P.O. BOX 940, HIGLEY, AZ 85236

by Samuel Macias Oropeza - 07:31 - 3 May 2024

Re: The OCA Functional Working Group asks for your help!

Hello everyone,

Given that documentation is the first interaction many have with our modules, it's crucial that the READMEs for each module and repository are clear, informative, and standardized. Currently, each README serves as an essential introduction to its respective module or repository, but many could benefit from further review and content enrichment.

With the advancement of AI technologies, we have a great opportunity to use these tools to efficiently review and generate content. This will not only improve the quality of our documentation but also make the modules more accessible and easier to use for new users and contributors.

I suggest we start a project to review the existing READMEs. This project could include the following steps:
1. **Initial assessment of all existing READMEs** to identify those that need urgent improvements.
2. **Development of a style guide or template** to ensure all READMEs follow a consistent format and contain all necessary information.
3. **Use of AI tools** to assist in content review and generation where applicable, ensuring accuracy and quality.
4. **Peer review**, where community members can contribute feedback before finalizing the documents.

After completing this initial phase of reviewing and standardizing our READMEs, it would then be worthwhile to pursue a platform or a new process for building out the documentation further. This would ensure that our foundational documents are strong before we expand our documentation infrastructure.

Best regards,

Marcel Savegnago (https://escodoo.com.br)

Em qui., 2 de mai. de 2024 às 10:02, Julie LeBrun <notifications@odoo-community.org> escreveu:

Thank you everybody for taking the time to answer and help.

We will be analyzing those options and communicating with some of you to have more information.

Julie LeBrun

Formatrice & Analyste en applications de gestion intégrée

+1 514-317-7944

Nouveau
Choisir un nom de projet comme un pro Découvrir
Le jeu. 25 avr. 2024 à 11:17, Raphaël Valyi <notifications@odoo-community.org> a écrit :
Hello,

just a word to also encourage mkdocs if we aim at something additional to the current README markdown system. As Graeme said mkdocs is popular, capable and simple to manage (we really need to avoid big new tools that would be an infrastructure burden to manage). I think the README are slowly being improved, even if it's still by the module tech authors. In OCA/l10n-brazil we try to slowly improve these README for instance. At some point improving these README is lowering the entry barrier to the OCA and it somewhat makes sense that this entry barrier is lowered at the same time than the code is cleaned up and migrated so that non alien people will eventually succeed in their project with the OCA instead of just accumulating frustration by trying to attract at all cost people which will not make it with the current ecosystem (something that Odoo SA does quite a lot themselves in fact). So I mean it is not that bad if that documentation pace isn't as fast as some people who don't use to deliver real projects may dream...
On Wed, Apr 24, 2024 at 11:27 AM Graeme Gellatly <notifications@odoo-community.org> wrote:
I second mkdocs. All my non technical staff use it to build docs. Most.jist write markdown bit some use a specialised markdown editor although that seems to fail lintimg quite a bit.

It is trivial to automate linting and deploy on merge.
On Wed, 24 Apr 2024, 6:52 am Victor Champonnois, <notifications@odoo-community.org> wrote:
Hello Julie,

>Do you know of any tool that could easily allow to edit and create PRs of README files in GitHub without the need of having GitHub knowledge? Something similar to what Weblate does for .po files ?

I think Weblate directly commits on the main branch, it does not create a PR.

As Andreas says, the edit functionality in Github seems like the simplest approach. However, it requires to create a fork of the repo, and to make a PR, so it's still a big barrier.
Victor Champonnois - Coop IT Easy
Tel : +32 475 81 01 12
On 24/04/24 07:44, Andreas Perhab wrote:

Hi Julie,

I think the edit button in github does most of the forking work for you and even helps with creating a PR when one is finished editing the readme (really any markdown file).

It puts images into /assets/{number}/{uuid} so that might need changing or we could just accept this additional directory.

regards Andreas

On Tue, 23 Apr 2024 at 19:32, Julie LeBrun <notifications@odoo-community.org> wrote:

Do you know of any tool that could easily allow to edit and create PRs of README files in GitHub without the need of having GitHub knowledge? Something similar to what Weblate does for .po files ?

Hello everybody!

During the last OCA Days, the OCA Functional Working Group (FWG) presented the work made on the Documentation Project.

This project was created by the FWG to help and attract functional people to contribute to modules documentation.

2 main options were analyzed

Using the existing Read Me file in the code so we have only one module documentation which regroups technical and functional information.

Using the GitHub Wiki on the repositories which could be really easy to put in place and use.

The decision was made to use the existing Read Me but to convert it into Markdown so it could be easier to use and to add images.

Following this decision, an issue was opened in GitHub about the use of the Wiki instead of Read Me : https://github.com/OCA/maintainer-tools/issues/606

BUT, we still have a big issue regarding this solution: the process to contribute to Read Me is really, really complicated for non-technicals.

You need to have a Github account and sign the OCA CLA

You would have to fork the repository (well, here we already have lost most of the non-technical people).

Then edit the files of the Read Me using the Web Editor (so you can add images).

Download your images in the right folder than insert them into the file by Drag & Drop

Create a commit and a PR.

Finally, the changes would need to be approved by contributors who have those access rights.

So, we were thinking: if we add a Markdown tool that can be used to edit Read Me files and automatically push the changes into GitHub a little bit like the Weblate tool, we could combine the PROS of both options analyzed.

Does anyone have any idea of this kind of tool?

Thank you in advance for your help.

The OCA Functional Working Group

fwg@odoo-community.org

_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe

_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe
_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe
_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe
--
Raphaël Valyi
Founder and consultant
http://twitter.com/rvalyi
www.akretion.com

_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe
_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe

--

		Marcel Savegnago
		marcel.savegnago@escodoo.com.br
		+55 16 99122-7649

A informação transmitida destina-se apenas a pessoa ou entidade a quem foi endereçada e pode conter informação confidencial, legalmente protegida e para conhecimento exclusivo do destinatário. Se o leitor desta advertência não for o seu destinatário, fica ciente de que sua leitura, divulgação, distribuição ou copia é estritamente proibida. Caso a mensagem tenha sido recebida por engano, favor comunicar ao remetente e apagar o texto do computador.

The information transmitted is intended only for the person or entity to which it is addressed and may contain confidential and/or privileged material. Any review, retransmission, dissemination or other use of, or taking of any action in reliance upon, this information by persons or entities other than the intended recipient is prohibited. If you received this in error, please contact the sender and delete the material from any computer.

by Marcel Savegnago - 02:36 - 3 May 2024

Re: The OCA Functional Working Group asks for your help!

Thank you everybody for taking the time to answer and help.

We will be analyzing those options and communicating with some of you to have more information.

Julie LeBrun

Formatrice & Analyste en applications de gestion intégrée

+1 514-317-7944

Nouveau
Choisir un nom de projet comme un pro

Découvrir

Le jeu. 25 avr. 2024 à 11:17, Raphaël Valyi <notifications@odoo-community.org> a écrit :

Hello,

just a word to also encourage mkdocs if we aim at something additional to the current README markdown system. As Graeme said mkdocs is popular, capable and simple to manage (we really need to avoid big new tools that would be an infrastructure burden to manage). I think the README are slowly being improved, even if it's still by the module tech authors. In OCA/l10n-brazil we try to slowly improve these README for instance. At some point improving these README is lowering the entry barrier to the OCA and it somewhat makes sense that this entry barrier is lowered at the same time than the code is cleaned up and migrated so that non alien people will eventually succeed in their project with the OCA instead of just accumulating frustration by trying to attract at all cost people which will not make it with the current ecosystem (something that Odoo SA does quite a lot themselves in fact). So I mean it is not that bad if that documentation pace isn't as fast as some people who don't use to deliver real projects may dream...
On Wed, Apr 24, 2024 at 11:27 AM Graeme Gellatly <notifications@odoo-community.org> wrote:
I second mkdocs. All my non technical staff use it to build docs. Most.jist write markdown bit some use a specialised markdown editor although that seems to fail lintimg quite a bit.

It is trivial to automate linting and deploy on merge.
On Wed, 24 Apr 2024, 6:52 am Victor Champonnois, <notifications@odoo-community.org> wrote:
Hello Julie,

>Do you know of any tool that could easily allow to edit and create PRs of README files in GitHub without the need of having GitHub knowledge? Something similar to what Weblate does for .po files ?

I think Weblate directly commits on the main branch, it does not create a PR.

As Andreas says, the edit functionality in Github seems like the simplest approach. However, it requires to create a fork of the repo, and to make a PR, so it's still a big barrier.
Victor Champonnois - Coop IT Easy
Tel : +32 475 81 01 12
On 24/04/24 07:44, Andreas Perhab wrote:

Hi Julie,

I think the edit button in github does most of the forking work for you and even helps with creating a PR when one is finished editing the readme (really any markdown file).

It puts images into /assets/{number}/{uuid} so that might need changing or we could just accept this additional directory.

regards Andreas

On Tue, 23 Apr 2024 at 19:32, Julie LeBrun <notifications@odoo-community.org> wrote:

Do you know of any tool that could easily allow to edit and create PRs of README files in GitHub without the need of having GitHub knowledge? Something similar to what Weblate does for .po files ?

Hello everybody!

During the last OCA Days, the OCA Functional Working Group (FWG) presented the work made on the Documentation Project.

This project was created by the FWG to help and attract functional people to contribute to modules documentation.

2 main options were analyzed

Using the existing Read Me file in the code so we have only one module documentation which regroups technical and functional information.

Using the GitHub Wiki on the repositories which could be really easy to put in place and use.

The decision was made to use the existing Read Me but to convert it into Markdown so it could be easier to use and to add images.

Following this decision, an issue was opened in GitHub about the use of the Wiki instead of Read Me : https://github.com/OCA/maintainer-tools/issues/606

BUT, we still have a big issue regarding this solution: the process to contribute to Read Me is really, really complicated for non-technicals.

You need to have a Github account and sign the OCA CLA

You would have to fork the repository (well, here we already have lost most of the non-technical people).

Then edit the files of the Read Me using the Web Editor (so you can add images).

Download your images in the right folder than insert them into the file by Drag & Drop

Create a commit and a PR.

Finally, the changes would need to be approved by contributors who have those access rights.

So, we were thinking: if we add a Markdown tool that can be used to edit Read Me files and automatically push the changes into GitHub a little bit like the Weblate tool, we could combine the PROS of both options analyzed.

Does anyone have any idea of this kind of tool?

Thank you in advance for your help.

The OCA Functional Working Group

fwg@odoo-community.org

_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe

_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe
_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe
_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe
--
Raphaël Valyi
Founder and consultant
http://twitter.com/rvalyi
www.akretion.com

_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe

by Julie LeBrun - 03:01 - 2 May 2024

Re: Github runners

Hello everyone,

An update on this important topic. ATTENTION and ACTIONS are required from all PSC and contributors.

Yesterday, I applied the project template to branches 14, 15, 16, 17.

Where the template did not apply cleanly a PR named "dotfiles update needs manual intervention" has been opened.

@PSC, please handle these PR as soon as you can. Big thanks to Pedro for processing quite a few of them already yesterday :)

@Contributors, before pushing additional commits to your existing PRs, please rebase, and check that .github/workflows/test.yml contains codecov/codecov-action@v4 and *not* v1.

I'll be looking at fixing older branches soon.

Thanks for your attention.

-Stéphane

On Tue, Apr 30, 2024 at 9:51 AM Stéphane Bidoul <stephane.bidoul@acsone.eu> wrote:

Hello everyone,

This is an annoying situation, which you can track here: https://github.com/OCA/oca-addons-repo-template/issues/250

I'll post there as the situation evolves.

Best regards,

-Stéphane

On Tue, Apr 30, 2024 at 9:46 AM Roussel, Denis <notifications@odoo-community.org> wrote:
Hi all folks,

@OCA/board Is there something changed about github runners configuration?

Since yesterday, runners seems to take a long time to get available resource:

Thanks for your support.
--

Denis Roussel
Software Engineer
T : +32 2 888 31 49
M : +32 472 22 00 57

Val Benoit, Quai Banning 6 | B-4000 Liège | Belgium
Atrium Building, Drève Richelle 167 | B-1410 Waterloo | Belgium
Zone industrielle 22 | L-8287 Kehlen | Luxembourg

_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe

by Stéphane Bidoul - 09:55 - 2 May 2024

Re: Github runners

Hello everyone,

This is an annoying situation, which you can track here: https://github.com/OCA/oca-addons-repo-template/issues/250

I'll post there as the situation evolves.

Best regards,

-Stéphane

On Tue, Apr 30, 2024 at 9:46 AM Roussel, Denis <notifications@odoo-community.org> wrote:

Hi all folks,

@OCA/board Is there something changed about github runners configuration?

Since yesterday, runners seems to take a long time to get available resource:

Thanks for your support.
--

Denis Roussel
Software Engineer
T : +32 2 888 31 49
M : +32 472 22 00 57

Val Benoit, Quai Banning 6 | B-4000 Liège | Belgium
Atrium Building, Drève Richelle 167 | B-1410 Waterloo | Belgium
Zone industrielle 22 | L-8287 Kehlen | Luxembourg

_______________________________________________
Mailing-List: https://odoo-community.org/groups/contributors-15
Post to: mailto:contributors@odoo-community.org
Unsubscribe: https://odoo-community.org/groups?unsubscribe

by Stéphane Bidoul - 09:56 - 30 Apr 2024

Archives

Contributors