Improving the Documentation or Write Now!

November last year we added a writer to our team here at the Atlassian office in San Francisco. Her first tasks were devoted to making new users successful with bitbucket. She rewrote and expanded our tutorial and our SSH documentation. Over 500 users have worked their way through the new tutorial. Big thanks to all the new bitbuckians who took the time to go through the tutorial and contribute to our quote site.

We only have our writer part time and we want to make sure we use her time wisely. For example, our current documentation set is on a Confluence wiki. It is possible for our users to write new or edit documentation in the wiki, but most bitbuckians simply comment on a page. Would you comment or contribute more or less if we made our documentation available in a bitbucket repo?

We know that the REST API doc could use some love but is it more important than Service Broker documentation? And well, our users may have their own ideas about how best to improve our documentation. So, our writer came up with three questions to focus her efforts. If you have a moment, please take the time to answer them:

Thank you to everyone who responded to our survey. We’ve collected over a hundred responses and closed the collection. If you want to comment on the docs, you can comment on this blog or scoot on over to our docs and leave a comment there.