> -Original Message-
> From: openembedded-architecture@lists.openembedded.org architect...@lists.openembedded.org> On Behalf Of Richard Purdie
> Sent: den 2 september 2023 09:20
> To: openembedded-core ;
> openembedded-architecture architect...@lists.openembedded.org>
> Cc: Michael Opdenacker
> Subject: [Openembedded-architecture] Changes needing documentation - a new
> procedure
>
> 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
I would recommend to make DOCS-WIP a directory where you drop one file
per change. That way you avoid all problems with conflicts during
testing, integration and cherry-picking. You also automatically get a
list of the pending changes by listing the files in that directory.
//Peter
-=-=-=-=-=-=-=-=-=-=-=-
Links: You receive all messages sent to this group.
View/Reply Online (#1744):
https://lists.openembedded.org/g/openembedded-architecture/message/1744
Mute This Topic: https://lists.openembedded.org/mt/101109973/21656
Group Owner: openembedded-architecture+ow...@lists.openembedded.org
Unsubscribe: https://lists.openembedded.org/g/openembedded-architecture/unsub
[arch...@mail-archive.com]
-=-=-=-=-=-=-=-=-=-=-=-