Activity: Test the docs in your open-source project
Now that you’ve read about testing, it’s time to get some more hands-on practice. In this activity, you’ll do some doc testing with an open-source project (or another project you identified).
Test a topic
-
With the open-source API project you’re working with, find the following:
- Getting started tutorial (or similar tutorial)
- API endpoint
-
Now test the documentation by walking through the documentation details. More specifically:
- For the Getting started tutorial, proceed through all the steps in the tutorial. Make a note of any assumptions that you found confusing, new terms or acronyms that were unfamiliar, or other questions you had. How long did it take to complete the getting started tutorial?
- For the API endpoint, make a request and examine the response. Does the response match what’s in the documentation? Try different variations of parameters in the endpoint and see if the responses are what you expect. Identify any incorrect or missing or inaccurate information.
-
If you found information that was incorrect, either log an issue or reach out to the QA lead with the feedback.
