bocoup / wpt-docs

A clone of the web-platform-tests project to collaborate on documentation reorganization
https://wpt-docs.readthedocs.io
Other
1 stars 0 forks source link

Describe capabilities in terms of contributor goals #3

Open jugglinmike opened 5 years ago

jugglinmike commented 5 years ago

Some of the content on authoring tests is organized according to the way it has been implemented. For example,

While logical, this framing may obscure information from first-time contributors since they must know how a feature is implemented in order to know where to look for its documentation.

Relocate the content to locations which describe contributor goals (e.g. "Controlling how resources are interpreted" and "Controlling network responses").