Issue Type
Generated by Generative AI
No
Distribution
N/A
Description
There are plenty of people wanting to volunteer … but it’s not always clear how to, or what’s most useful to do. In particular, the first contribution is a major barrier (“a cliff”). So picking out some achievable first bits and making it really easy to achieve them will be very valuable.
There’s lots of existing info - but it’s hard to pick out useful stuff, and not exactly encouraging.
OR also want to encourage contributions other than coding so suggesting these will be helpful.
Provide guidance for the ROS community, including:
- How to contribute to [project]
- Including how to file an issue
- Including how to make a pull request
- Including how to review a pull request
- How to get involved in [project]
- Meeting participation
- Discussion participation (meetings and async BBS/chat)
- How to participate in the community
- Hosting an online community group event
- Hosting a local meet-up
- Running a local ROSCon
- How to participate in the OSRA (limited distribution document)
- Plus anything else that fits in these topics.
Affected Pages/Sections
No response
Screenshots or Examples (if applicable)
No response
Suggested Fix
- Update distribution and site home pages to fit with new docs about contributing
- Update Contact page to fit with new docs about contributing
- Create Reporting an issue - how-to
- Restructure and update articles about contributing to docs
- Create Contributing to ROS - About
- Information gathering/Analysis
- Create Reviewing a PR - how-to
- Create Making a PR - how-to
- Create Triaging an issue - how-to
- Restructure articles about coding guidelines
Additional Context
No response
Issue Type
Generated by Generative AI
No
Distribution
N/A
Description
There are plenty of people wanting to volunteer … but it’s not always clear how to, or what’s most useful to do. In particular, the first contribution is a major barrier (“a cliff”). So picking out some achievable first bits and making it really easy to achieve them will be very valuable.
There’s lots of existing info - but it’s hard to pick out useful stuff, and not exactly encouraging.
OR also want to encourage contributions other than coding so suggesting these will be helpful.
Provide guidance for the ROS community, including:
Affected Pages/Sections
No response
Screenshots or Examples (if applicable)
No response
Suggested Fix
Additional Context
No response