In a world in which many developers (myself included) use web search as their first avenue of inquiry when they run into a technical problem, it's important for platform providers to have technical content that is thorough, well-organized, and discoverable from web search engines. (This means that you should apply the principles of search engine optimization to your entire site, not just the marketing bits.)
Way too many technology products expect third party developers to flock to their platforms on the strength of the product alone, without providing any documentation to help them get started. Documentation isn't an amenity, it's a requirement.
If your documentation isn't easily searchable, then 10-70% of current and prospective developers aren't going to be able to find your documentation when they need it.
Keeping your developer content up to date as your platform evolves is another big challenge. Microsoft does a …
[Read more]