...
- Overview topics explaining high-level ASF concepts, what ComDev does, and pointing tech questions to ASF projects themselves
- Best practices (for specific audiences) (question: do we have energy to make different versions of contributor ladder? Developers, testers, designers, writers, etc. each have different interests and paths)
- Beginner
- Contributor
- See the Contributor Ladder concept at https://github.com/cncf/project-template/blob/main/CONTRIBUTOR_LADDER.md
- Committer
- PMC
- Understanding the role of the Chair
- Reporting tips/guidelines (Examples of good reports!)and official PMC Board Reporting Guide
- How/When/Why to promote committers, PMC members
- Some sort of general pointer to projects.a.o or other information reminding newcomers how many separate projects we have
- Links to other conceptual best practices (these are important on the larger scale)
- ComDev Mailing list page (with brief intro of "here's how to ask questions - use this list")
- Project Independence https://community.apache.org/projectIndependence.html
- Maturity Model https://community.apache.org/apache-way/apache-project-maturity-model.html
...
- Links to various "What is the ASF Way" and orgchart kinds of information to help explain how the ASF relates to all ASF projects (like ComDev)
- Event participation
- GSoC
- ALC
- Required links to Apache.org pages (see ASF policy requirement)
- Tools
- COMDEV JIRA instance
- Projects.apache.org
- Helpful info about updating DOAP
- Should we actively reach out to projects with wrong/old/missing DOAP? (yes, but how do we do it effectively?)
- Reporter.apache.org - Also links to PMC Board Reporting Guide
- Link to "how to make PRs for this website" page: https://github.com/apache/comdev-site#how-to-publish-the-website
- Note: linking to GitHub helps people understand they can make PRs, but doesn't actually help non-git people understand "how do I fix this typo". so we should figure out how to explain the "very simple process for suggesting a change" somewhere too. See also FAQ: https://community.apache.org/newbiefaq.html#websitecms
Q&A
Q: do we have energy to make different versions of contributor ladder? Developers, testers, designers, writers, etc. each have different interests and paths
A: The main contributor ladder (Contributor → Committer → PMC → Foundation-level governance and membership) is the same for all contributors. Having multiple of these seems like it would unnecessarily complicate something simple, and obscure the central message that there is a path to leadership for everyone, regardless of their interests and skills. The definition of governance, in open source is 1) an explanation of who makes the decisions and 2) an explanation of how you get there. That is the sole purpose of the "ladder", and we should not complicate that by listing all possible flavors.
Q: How do we effectively help projects with their DOAP files
A: There are several ways we could do this, depending on their expertise and interest:
- Notify them that their DOAP is missing/inaccurate
- Point to resources about how and where to update it.
- Generate possible DOAP for them (there are tools for this) and then encourage them to update it to complete accuracy