-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
3dabadd
commit 99af35f
Showing
2 changed files
with
36 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,34 @@ | ||
.. _methodology: | ||
|
||
=========================== | ||
Field research: methodology | ||
=========================== | ||
|
||
This page outlines how I approach all my field research. | ||
|
||
-------------------------------------------------------- | ||
Heavy bias towards docs sites for computer professionals | ||
-------------------------------------------------------- | ||
|
||
I write docs for software engineers. My research is heavily biased towards | ||
docs sites for these people. The docs sites for people in other domains | ||
are under very different constraints. However, over time I may try to sample | ||
docs sites from other domains precisely because they might approach the same | ||
problem very differently than docs sites for software engineers. | ||
|
||
----------------- | ||
Docs site "types" | ||
----------------- | ||
|
||
I aim to get a wide-range of samples from different "types" of docs sites. | ||
The docs sites for code libraries, CLI tools, programming languages, and | ||
platforms are all under very different constraints and therefore often solve | ||
the same problem in very different ways. | ||
|
||
------------- | ||
Popular sites | ||
------------- | ||
|
||
I lean towards studying docs sites for products that I know to be popular. The | ||
rationale is that these sites essentially condition us around what's normal | ||
and what's not normal for a docs site. |