Skip to Content

Contributors

Re: README generator update

Thanks for the great work!!

On Sun, 3 Sept 2023, 14:07 Stéphane Bidoul, <notifications@odoo-community.org> wrote:
Hi everyone,

Today I deployed a new version of the README.rst generator in the OCA GitHub bot.

It includes several important improvements:
  • Support for a CONTEXT fragment to document the use case and/or when to use the addon. 🙏
  • Support for markdown fragments (more on that soon). ✨
  • "Try me" links to runboat instead of runbot.
  • Various minor other improvements contributed over the last 3-4 years.
The reason it was not deployed sooner is that every tiny change in the generated README.rst did cause a full CI run and publication to PyPI for all our 10k+ addons across branches. Now the generated document contains a digest of the source content and it is re-generated only when the fragments or manifests change and not when the generator changes.

A full rebuild is in progress right now. Please be patient until the CI queue processes everything.

Best regards,

-sbi

--
Stéphane Bidoul
http://acsone.eu/

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


by Enric Tobella Alomar - 02:11 - 3 Sep 2023

Reference

  • README generator update
    Hi everyone,

    Today I deployed a new version of the README.rst generator in the OCA GitHub bot.

    It includes several important improvements:
    • Support for a CONTEXT fragment to document the use case and/or when to use the addon. 🙏
    • Support for markdown fragments (more on that soon). ✨
    • "Try me" links to runboat instead of runbot.
    • Various minor other improvements contributed over the last 3-4 years.
    The reason it was not deployed sooner is that every tiny change in the generated README.rst did cause a full CI run and publication to PyPI for all our 10k+ addons across branches. Now the generated document contains a digest of the source content and it is re-generated only when the fragments or manifests change and not when the generator changes.

    A full rebuild is in progress right now. Please be patient until the CI queue processes everything.

    Best regards,

    -sbi

    --
    Stéphane Bidoul
    http://acsone.eu/

    by Stéphane Bidoul - 02:06 - 3 Sep 2023