I would like to propose some better ways to search documentation.
Right now if I want to find something in the documentation it's terribly difficult. It's good to make people write good documentation and stop plagiarism and fix rep so on, and I know SO has a focus more on good answerers than askers - but the end goal of all this is to create a searchable repository of knowledge.
Problem
I tried to lookup some documentation, and it was cumbersome (and not only because it doesn't show up in Google results). Some major points:
- I have to navigate to the tag
- I have to navigate to the topic, thus know how it is worded
- Alternately, I can use the search inside the tag, which is not really helpful because
- It only returns examples
- The order of examples seems terrible to say the least
- Suggestions dropping down from the search box can be useful but are slow to show/update
Take this really simple example: I want to know how to commit with Git, simply and quickly, rather than having to read all of this. Here's my Docs.SO experience:
- Go to https://stackoverflow.com/documentation
- Type "git", click Git in the filtered boxes
- Glance at first five topics (because I can't be asked to scroll); nothing on commits
- Type "commit" in search box
- Wait a second, still only "Popular" topics in dropdown list
- Press enter and go to this horrible page where I don't know what link to choose and most of them seem unrelated (for that specific issue, see other questions).
- Abandon and turn to Google
That's obviously a poor experience.
Suggestions
Here's a two pretty concrete ideas to improve the state of the search.
Make search page show topics. Whether it is mixed with examples or separate doesn't matter. Just show the topics that already appear in the drop-down menu, in case I missed them.
Rationale: I think the goal of having topics with examples pinned and ordered per votes is to get a nice, sightly presentation where one can choose the specific interesting example. We should direct readers there, and let them look at examples from that page.
Plus, topics are much easier to get right from a simple query.
Give us a search box where you can use "[tag] query" that redirects to
https://stackoverflow.com/documentation/search?tag={tag}&query={query}
This is similar to the Q&A search and would cut out most of the steps described above. Optionally offer helpful message of similarly named tags if misspelt/doesn't exist/etc.
Maybe next to the "Type to find a tag: " box, we could have a "Search documentation: " with "[tag] query" as background text.
<meta name="robots" content="noindex, nofollow" />
) so you won't find it on google