I've been concerned for a while about the process of adding documentation influencing changes. Our docs are in a separate repo and this does have advantages. They do span multiple areas of the project and in general this does work well for us. It does mean the docs are consistent and have a common style/voice.
Equally, it is hard to ask users to add documentation changes in their commits and this leads to the docs having to play catchup and pushes a lot of work to the docs maintainers. We're therefore going to try something new where I'll ask people to add notes to a file in OE-Core, DOCS-WIP when they make a change which needs docs updates. This will include changes which need a release notes or migration guide entry. The docs maintainers will then know what needs to be done and hopefully have at least the basic information they need to make the docs changes needed. This is an experiment but hopefully one that will be successful and let our docs continue to grow. Cheers, Richard
-=-=-=-=-=-=-=-=-=-=-=- Links: You receive all messages sent to this group. View/Reply Online (#1743): https://lists.openembedded.org/g/openembedded-architecture/message/1743 Mute This Topic: https://lists.openembedded.org/mt/101109973/21656 Group Owner: [email protected] Unsubscribe: https://lists.openembedded.org/g/openembedded-architecture/unsub [[email protected]] -=-=-=-=-=-=-=-=-=-=-=-
