search

todogroup / todogroup.org

Official TODO Website that containts TODO Guides, OSPO use cases and more resources to advance in the OSPO journey
http://todogroup.org
Other
242 stars 125 forks source link

WIP: Draft for Employee Open Source Engagement Guide #384

Closed cornelius closed 1 year ago

cornelius commented 1 year ago

This draft is based on the content and discussions in the issues of the "Employee Open Source Engagement Guide" milestone. It tries to capture the text which was drafted in the issues and the additional thoughts and discussion points which were raised there and adds some introductory and supplementary text.

The structure is based on the six principles of authentic participation. There is a section for each principle starting with a short summary, then some explaining text, and ending with a list of tactics which can be applied to implement the principle. For the first principle we already had a great list of tactics in the issue, for the other principles I tried to come of with some thoughts for tactics. These should still be expanded. It feels like these could be very useful for people reading the guide.

Feedback, comments, questions, additions are much appreciated. We can use this pull request and the git branch where it lives to discuss the content of this guide further. Once we have agreed on the final content we can merge it in order to publish the guide.

For concrete proposals for changes to the draft before publishing we can use pull requests using the guide-employee-open-source-engagement branch as a target and discuss these changes in these pull requests.

anajsana commented 1 year ago

@cornelius yesterday we moved into production a major update on the website to enhance accessibility and user experience. These developments were under the redesign branch that now has been pushed to main.

This update changed the folder architecture, which means that there is a conflict with this old PR, since now it makes changes to an outdated folder structure.

Since there haven't been any comments or additions to the original PR, the simplest solution would be to label this PR as a duplicate and open a new PR with the same content, so the new one is aligned with the updated version of the website. That will allow us to rebase and merge the PR 👍 What do you think?

cornelius commented 1 year ago

Since there haven't been any comments or additions to the original PR, the simplest solution would be to label this PR as a duplicate and open a new PR with the same content, so the new one is aligned with the updated version of the website. That will allow us to rebase and merge the PR 👍 What do you think?

I can also resolve the conflict in the existing pull request, so we don't have to duplicate anything. Will have a look later.

cornelius commented 1 year ago

The guides are automatically picked up now, so no change to the _index file is needed anymore.

gkunz commented 1 year ago

Hi all, I just came across your guide - and I must say it is great! I should have realized earlier that this is ongoing. It is still marked as WIP, but may I already refer to it?

cornelius commented 1 year ago

Unfortunately the GitHub feature, which commits suggestions from comments, doesn't seem to correctly handle accounts with multiple email addresses and used the wrong email address for signoff when I added the suggestion from the comment adding the new principle about continuing with participating. This breaks the check for the DCO.

I have created a new branch which fixes the problem and created a new pull request #397. I will close this pull request now. All further discussions and refinements should go into the new pull request.

cornelius commented 1 year ago

Hi all, I just came across your guide - and I must say it is great! I should have realized earlier that this is ongoing. It is still marked as WIP, but may I already refer to it?

Hey @gkunz, glad that you like the guide. I think it's ok to already refer to it, but be aware that things still might change. The latest draft of the text for the guide is in #397 now.