[prev in list] [next in list] [prev in thread] [next in thread] 

List:       openembedded-architecture
Subject:    Re: [Openembedded-architecture] New Contributors Guide
From:       "Douglas Royds via lists.openembedded.org" <douglas.royds=taitcommunications.com
Date:       2023-09-04 0:05:57
Message-ID: eca173d7-74ee-aebd-a97a-64c9e06ce6fc () taitcommunications ! com
[Download RAW message or body]

Nice work.

No description of the "Upstream-Status:" tag appears to have found its 
way into the new Contributor Guide. Was this deliberate?

See 
https://www.openembedded.org/index.php?title=Commit_Patch_Message_Guidelines&oldid=10935#Patch_Header_Recommendations:_Upstream-Status



On 31/08/23 8:31 am, Richard Purdie wrote:
> Hi All,
> 
> The OE TSC has been aware of the feedback around our contributions
> process and the state of our docs on the subject, with many different
> wiki pages, some of which disagree with each other.
> 
> It isn't something a newcomer to the project can untangle, it needed
> people with authority and in some ways "bravery" to do something
> radical to improve the situation.
> 
> After discussion, the OE TSC has decided to do just that. Along with
> the YP TSC, we agreed to take the various "contributions" wiki pages
> and docs and pull them together into a new "Contributors Guide" manual
> as part of the rest of "our" docs bookshelf.
> 
> Rather than discuss this, we've done it, it is here:
> 
> https://docs.yoctoproject.org/dev/contributor-guide/index.html
> 
> This is the work of a number of us and we did pull in help from Michael
> Opdenacker to help us make this happen, thanks to all involved!
> 
> We've gone and made a number of wiki pages point at this where we
> believe the content was migrated, duplicated or obsolete. I've also
> just sent out patches to some of the core repository README files to
> update those to match.
> 
> We've tried to add sections to the docs to cover things which we could
> assume 10 years ago but which are perhaps not common knowledge to a
> newcomer now.
> 
> We're aware this won't be perfect and there may be areas that need
> improvement or maybe where people disagree. As ever, the docs are a
> living entity and evolve over time so patches welcome, as ever. This
> effort by the TSCs was mainly to get us over the hump of starting
> something, having a fairly ruthless cleanup of the wiki and giving us a
> basic canvas to work on together.
> 
> If anyone has new people working on the project, please test them out
> on the new guide, we'd love to know what is clear, what isn't and if
> there is anything we should improve.
> 
> Also, if anyone spots wiki docs or other information that should be in
> the manual, please let us know too.
> 
> Cheers,
> 
> Richard
> (channelling both TSCs)
> 
> 
> 
> 



-=-=-=-=-=-=-=-=-=-=-=-
Links: You receive all messages sent to this group.
View/Reply Online (#1745): \
https://lists.openembedded.org/g/openembedded-architecture/message/1745 Mute This \
Topic: https://lists.openembedded.org/mt/101061316/4454510 Group Owner: \
                openembedded-architecture+owner@lists.openembedded.org
Unsubscribe: https://lists.openembedded.org/g/openembedded-architecture/unsub \
                [openembedded-architecture@marc.info]
-=-=-=-=-=-=-=-=-=-=-=-



[prev in list] [next in list] [prev in thread] [next in thread]