On Tue, 5 Sept 2023 at 21:32, Richard Purdie <[email protected]> wrote: > This has proven contentious. Whilst I think it would help our docs > maintenance, there are differing views: > > * it should be a directory for conflict reasons > * we don't want a top level directory for this > * we don't want a directory called "WIP" as it looks bad > * we shouldn't have "partial" half way staging, either the docs are in > repo or they're not > > I'm weary, I can't reconcile the views being expressed, some people > haven't clearly haven't read or understood the proposal reasoning and > its turning into a perfect bike shedding exercise. > > Much as I think it would be the right direction, some people won't be > happy, the complaints are going to annoy me and I'm going to abandon > the patch.
Ugh, this is *not* the outcome I was expecting. Whoever is bike shedding: shame on you. My two eurocents: 1. Top level directory is fine. 2. Top level directory called 'WIP' is fine, if it's not in a release or a stable branch. 3. I'm regularly adding features or changing behavior that require doc updates. I'm just as regularly forgetting to document what I'm doing, and this would've helped. The most notorious example is per image license checks which went undocumented for several years. I'm going to resurrect this with the upcoming Y2038 fixes, or oe-setup-build rewrite that I just did, but holding off due to feature freeze. Alex
-=-=-=-=-=-=-=-=-=-=-=- Links: You receive all messages sent to this group. View/Reply Online (#187255): https://lists.openembedded.org/g/openembedded-core/message/187255 Mute This Topic: https://lists.openembedded.org/mt/101109943/21656 Group Owner: [email protected] Unsubscribe: https://lists.openembedded.org/g/openembedded-core/unsub [[email protected]] -=-=-=-=-=-=-=-=-=-=-=-
