Forem

Matt Layman
Matt Layman

Posted on • Originally published at mattlayman.com

Customer Docs - Building SaaS #85

In this episode, I integrated customer documentation into the app. I showed how to build Sphinx documentation into a Django project, then created a help view to link to the docs. Finally, I added documentation building to the deployment process.

I previously created a Sphinx documentation project to hold docs for my app, but I had not hooked the docs into my project yet. Before hooking it in, I explained how Sphinx works and how I customized the documentation to fit with my project.

I started by integrating documentation building into my Continuous Integration tools. This will check to make sure that my docs continue to build so that I'll know that things are safe to deploy.

After adding to CI, I plugged the generated documentation into the Django app so that WhiteNoise could show the files. I did this by using my custom version of the WhiteNoise middleware that can add any extra static files that I want.

Once the docs could be served by the app, I changed the footer to point to the documentation. After playing with that, I realized that I want a help page before directing users straight to the documentation.

I created a new view to describe how users can get help. In this view, I included a support email address. We wrote some tests to make sure it all worked.

To finish off the effort, I added documentation building to the deployment process so that Heroku will also have the generated documentation. We also added a step to make sure that Heroku will have compressed versions of the documentation that WhiteNoise can serve like gzip or brotli versions.

At the end of the stream, I talked about some of the projects that I'm going to tackle for next year.

Image of Datadog

The Essential Toolkit for Front-end Developers

Take a user-centric approach to front-end monitoring that evolves alongside increasingly complex frameworks and single-page applications.

Get The Kit

Top comments (0)

Image of Datadog

Create and maintain end-to-end frontend tests

Learn best practices on creating frontend tests, testing on-premise apps, integrating tests into your CI/CD pipeline, and using Datadog’s testing tunnel.

Download The Guide

👋 Kindness is contagious

Explore a sea of insights with this enlightening post, highly esteemed within the nurturing DEV Community. Coders of all stripes are invited to participate and contribute to our shared knowledge.

Expressing gratitude with a simple "thank you" can make a big impact. Leave your thanks in the comments!

On DEV, exchanging ideas smooths our way and strengthens our community bonds. Found this useful? A quick note of thanks to the author can mean a lot.

Okay