Search-first writing for non-writers

A session at Open Source Bridge 2013

Thursday 20th June, 2013

3:45pm to 4:30pm (PST)

Tags and keywords, in their best form, contain words that never appear in your document or your software. They are the words that people are using to look for information. Ideally, you wouldn't generate these ideas yourself, you would glean them from users who are looking for things. You would find them in failed searches and google queries and stack overflow questions, and you would realize that although you think of this feature as the "queuing engine", the people on the ground appear to call it the "queue management system". So when you tag, you would use "queue management system" as one of your terms, and tie it to the queuing engine instructions.

Your tags and folksonomy should also serve to disambiguate conceptual information from instructions. You may know what a webserver is, thankyouverymuch, but need to know how to configure this particular one. The metadata should make it clear which is concept and which is execution.

Attend this talk if you want a quick thumbnail on how to make the casual documentation you do more useful for searches.

About the speaker

This person is speaking at this event.


Coverage of this session

Sign in to add slides, notes or videos to this session

Tell your friends!


Time 3:45pm4:30pm PST

Date Thu 20th June 2013

Short URL


Official session page


View the schedule



See something wrong?

Report an issue with this session