Activity 9a: Find an open-source project with API doc needs
Activity 9b: Find an open-source project with API doc needs
To find an open-source project with API doc needs:
- Go to the GitHub Advanced Search.
Under the Issues Options section, in the With the labels row, type
help wanted. This is a standard tag that teams use to attract volunteers to their project (but some teams that need help might not use it).
Scroll to the top and notice that
label: "help wanted"automatically populates in the field.
In this Advanced Search box at the top, add some additional keywords (such as
API documentation) as well:
Click Search and browse the results.
As you browse the results, are there any projects that look interesting or promising? If so, great. If not, adjust some of the keywords and keep looking.
If searching GitHub doesn’t yield any appropriate projects, try the following resources:
Note: You could spend a long time evaluating and deciding on open source projects. For this activity, it’s okay if you focus on a project that looks only mildly interesting. You don’t need to commit to it. You can always change it later.
- Trending GitHub projects
- Up for Grabs
- Bus Factor
- Code Triage
- 24-hour Pull Requests
- Programmableweb.com API directory
After selecting a project, make notes on the following:
- Does the project involve a REST API?
- How does the project tag documentation-related issues? For example, does it use the “documentation” label?
- Identify the current state of the project’s documentation. Are the docs robust, skimpy, nonexistent, extensive?
- How active is the project? (What is the frequency of commits?)
- How many contributors does the project have?
You don’t have to actually reach out or interact with the team yet. You’re just gathering information and analyzing documentation needs here.
16/150 pages complete. Only 134 more pages to go.
Want to buy me lunch? Click the Donate button below to donate any amount through Paypal.