docs icon indicating copy to clipboard operation
docs copied to clipboard

Reduce links to support articles

Open mattheworiordan opened this issue 6 years ago • 0 comments

We've historically used links to support articles as it's easier to add arbitrary support articles. However, this approach has a serious downside for customers who are reading our docs as the experience becomes inconsistent.

I think support articles will continue to have their place to address specific questions and provide answers, but I believe our goal should be that anyway who is using our docs, should in almost all cases never need to leave the docs.

Doing this will require us to:

  • [ ] Think about how we structure the docs, specifically where pages live that don't exist in the nav
  • [ ] Review which support articles should become documentation, and review all docs that link to support.ably.io -

┆Issue is synchronized with this Jira Task by Unito

mattheworiordan avatar Sep 21 '19 10:09 mattheworiordan