Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add a "what's new" page to the devguide #885

Open
ezio-melotti opened this issue Jun 7, 2022 · 0 comments
Open

Add a "what's new" page to the devguide #885

ezio-melotti opened this issue Jun 7, 2022 · 0 comments
Assignees

Comments

@ezio-melotti
Copy link
Member

@ezio-melotti ezio-melotti commented Jun 7, 2022

During the last docs-community meeting, we discussed the fact that we are currently using several different tools (git, GitHub, Discourse, Discord, etc.) and each tool has a learning curve. Combined with the fact that the tools change and evolve over time, it's difficult for the devs to use them proficiently and effectively.

Documenting how to use them in the devguide is useful, but devs rarely re-read the devguide to discover these new sections. I therefore propose to create a "What's new" page to list significant additions and changes to the devguide, to make these more discoverable.

I think it will also be useful to post these entries with a regular cadence (e.g. monthly) on Discourse, so that people don't have to actively check the "What's new" page and remember when was the last time they checked.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant