Hi Rancher Community,
I wanted to provide an update on the doc schedule. Right now, we’ve moved back some of our dates listed below by a week or so. I’m splitting time between writing the documents promised below, while keeping up with work being done by the dev team around external authentication. If you have any questions about the schedule, feel free to ask below!
I’m Mark Bishop, the technical writer here at Rancher. After reading many of the threads on our forum, I know the Rancher community has concerns about the current lack of documentation around the 2.0 release. Your concerns are completely warranted–I know how frustrating a lack of documentation can be.
Starting today, I want to be more transparent about our documentation schedule: when you can expect updates, what topics will be covered in those updates, etc. Here’s what I have planned:
Doc Release Schedule
The end of this post includes a rough schedule of planned documentation updates and the topics that they’ll cover. My hope is that the community will chime in and help us prioritize which topics to cover first. I will post this schedule here in the forums as a sticky thread. These dates are subject to change, but we’ll keep you updated of any schedule changes.
Doc Release Notes
As I publish documentation updates, I’m going to publish release notes along with them. These notes will provide a high-level summary of the changes in each drop. This way you can stay on top of any documentation that you need to support your Rancher setup.
Again, I’ll post these notes as a sticky thread here in the forums I’ll post these notes in the Rancher Docs GitHub Repo.
Lastly, I’m going to spend more time in the Rancher forums and the Rancher Slack channels to monitor where the community needs more documentation. I understand how frustrating it can feel when the user community doesn’t receive the interaction it deserves. To that end, I’ll keep an eye out for trending issues, direct users to existing documentation, and post links to doc updates and release notes in our Slack channel.
Finally, an apology from me! In keeping my head down writing docs, I’ve done a disservice to you, our customers. Often, the lack of response is more frustrating than the problem itself. I apologize for the radio silence, and I look forward to working with you guys to improve our doc set
Technical Writer @ Rancher
How to add resources to a project in support of your workloads. Resources covered include:
- Sidecars, Ingress, and DNS Records
How to add storage for your Rancher clusters, including storage from cloud services such as Amazon, Azure, etc.
Alerts and Notifiers:
How to configure Rancher to inform you when important events occur within your clusters.
How to enable logging for your clusters and projects.
How to scale the number of nodes in your cluster up or down.
The Rancher community is requesting API docs! I’m going to investigate scope and come up with an estimate for these docs. I’ll post a date when I have more information