How to properly publish documentation and update components in the registry?

[UncleRus]

@trombik , could you explain this to me? I'm just a little shocked by the amount of work you've done on CI.

[trombik]

@UncleRus Have not documented the whole process but here is what I have documented so far:

https://github.com/esp-idf-lib/shared-workflows

The workflows will not surprise anyone (I hope).

Development:

• creating a PR runs the build CI and other workflows, including validations
• merging a PR runs the same workflows and publish the latest doc on GitHub Pages
• creating a release runs publish-esp-component-registry.yml

Manual operations are:

• Writing a release note
• Creating a release and publish it

Tricky part is when you need to update all the components, such as adding new common workflows, updating all components by one minor version. For these, helper tasks are available in release.rake (gh CLI tool is required).

[UncleRus]

Thank you!