acsrujan / sensu-docs Goto Github PK

Welcome to the Sensu Docs project! This repository is the home of docs.sensu.io.

Read the docs | Contributing guide | Style guide | Code of conduct | Contact admins | Open an issue

We welcome all contributions! Read the contributing guide to get started.

For details on formatting and style, see the Sensu Docs style guide. If you have any questions, please submit an issue, or feel free to reach out in #documentation in the Sensu Community Slack.

From the docs site, select "Edit this page" to go to the corresponding markdown file in GitHub. From there, GitHub will prompt you to create a fork and submit a pull request. You can also submit documentation feedback by opening an issue.

The Sensu Docs site is a static site built with Hugo and markdown. These instructions will help you get the site running locally.

To contribute to the Sensu Docs, please read the contributing guide.

• Install Git on your computer and authenticate using HTTPS or SSH. Skip this step if you already have Git set up and authenticated on your computer.

• Install Yarn on your computer. Sensu Docs uses Yarn to manage dependencies and the build process.

You can clone the repo using either HTTPS or SSH.

Clone using HTTPS:

git clone https://github.com/sensu/sensu-docs.git && cd sensu-docs

Clone using SSH:

git clone [email protected]:sensu/sensu-docs.git && cd sensu-docs

If you prefer, download the repo from GitHub.

Run:

yarn

This will install Hugo and build the site into the public directory.

If the site builds successfully, run:

yarn run server

This builds the Hugo server so you can view the site in your local web browser at http://localhost:1313/.

Here are some things to try if you encounter an issue working with the site:

• Run yarn hugo-version to print the running version of Hugo. Version 0.56.1 or newer is required.
• If you're still having trouble viewing the site, open an issue, and we'll be happy to help!

This project uses a fork of the wonderful hugo-material-docs theme.

Offline documentation uses a set of layouts located in the offline directory. To preview them:

yarn run server --layoutDir=offline

To exclude content from the offline documentation, the following can be added to a markdown file's front matter:

offline: false

Whenever changes are merged to the master branch, this project is automatically deployed to docs.sensu.io. For additional details on Heroku configuration and deployment, see our wiki page.