Archives
Contributors
Re: README generator update
Thank you very much!
by Pedro M. Baeza - 08:12 - 4 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
by Stéphane Bidoul - 02:06 - 3 Sep 2023 - Support for a CONTEXT fragment to document the use case and/or when to use the addon. 🙏