Sharing our challenges, mistakes, hacks, successes, opinions and news
This weekend I attended Write the Docs + Open Help Cincinnati [https://www.writethedocs.org/conf/cincinnati/2018/]. Write the Docs + Open Help is an event that brings together documentation contributors to share and learn from one another. The weekend included a day of talks and day of unconference sessions and lightning talks. It also included three days of documentation sprints led by Open Help [http://openhelp.cc/], which I was unable to attend. I work as the main contributor and maintainer
As part of our strategy towards going open source, we wanted to make several improvements to our documentation. There were a few problems we wanted to address: 1. There was no clear explanation of why you would want to use Cypress. 2. There were no clear “Getting Started” guides that introduced you to Cypress. 3. Most API commands were missing explanations of critical core concepts. 4. We found many users were confused by the Cypress ✨ magic ✨. 5. Our users asked the same ques