We're working on improving Confluence Cloud docs - here's what we've done so far

This year, we’ve been making some positive changes to the Confluence Cloud developer docs (developer.atlassian.com/cloud/confluence). We identified some areas where content could be organized better, found and fixed some inaccuracies, and added some information to connect the dots better. Here are a few of the highlights:

  • There are more and better descriptions of parameters and objects in the REST API documentation
  • The tutorials are now named so that you know what to expect
  • A number of problems with the Getting started tutorial were fixed, and information added to provide context
  • The Security section has been reorganized
  • There’s a new Webhooks tutorial
  • The Macro tutorial was completely rewritten (and the Macro body content was broken out separately)

We also fixed a bunch of bugs. Most of the issues you reported using the “Rate this page” form (it’s not just about stars!) were about broken links, typos, and incorrect parameters. We focused on fixing inaccuracies that had cost developers unnecessary time, and prioritized pages that had the largest number of issues.

We know there’s always more to do. We’ve been looking at site traffic and site search to see what people want to know more about, reading the forum, and of course collecting your feedback. Over the next few months, we plan to add more how-to pages for specific tasks to the Connect cookbook. If you have specific suggestions, please let us know.