diff options
author | Mantas <mistermantas@users.noreply.github.com> | 2017-10-23 18:56:13 +0300 |
---|---|---|
committer | GitHub <noreply@github.com> | 2017-10-23 18:56:13 +0300 |
commit | 4bc818712d9b0133dd22326052a99ef1f36f4aa0 (patch) | |
tree | 6d9e3dc80af8c946042999ff12532f07b314b5a5 | |
parent | 85ecb551b27597a5988a2622b7e3830516e063a9 (diff) |
Slightly better docs
-rw-r--r-- | README.md | 48 |
1 files changed, 32 insertions, 16 deletions
@@ -10,25 +10,50 @@ Is [statuspage.io](https://www.statuspage.io/) too expensive? Do you need an ope [![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/mistermantas/cstate) -## Usage +## Table of Contents -To set up cState, do the following: ++ [Features](#features) ++ [Installation](#installation) + + On Netlify + + GitHub Pages ++ [Contribute](#contribute) ++ [License](#license) -1. Deploy the status page, preferably using [Netlify](https://app.netlify.com/start/deploy?repository=https://github.com/mistermantas/cstate) and/or [GitHub Pages](https://pages.github.com). +## Features + ++ Built with [Hugo](https://gohugo.io), on a sturdy foundation ++ Works everywhere: all modern browsers, even IE8 and later ++ You can subscribe to web notifications for status updates ++ Simple, focused, and robust design ++ Easy to edit and deploy + +## Installation + +### On Netlify + +1. [Deploy to Netlify](https://app.netlify.com/start/deploy?repository=https://github.com/mistermantas/cstate). 2. Upload your favicon and logo to `/static/` and edit `config.yml`. -Once that is done, you can create a new post like this: +### Everywhere Else + + + +## Creating Incident + +Once in the project root directory, you can create a new post from the command line like this: ``` hugo new incident/dns-killed-us.md ``` +Essentially, just go into `content/incident` and add a new file. This will be an incident. The file name will indicate the URL of the incident. So, for example, if you create `dns-killed-us.md`, the URL will lead to `status.example.com/incident/dns-killed-us`. + Then, go into `incident/dns-killed-us.md` and follow this format: ```md --- Title: Catastrophic DNS failure -Description: After moving from one server to another, some DNS settings had unknowingly been tweaked which caused a complete outage for everything hosted on our domain. +Description: After moving from one server to another, DNS just kinda gave us the middle finger. Ugh. Date: 2017-04-04T15:58:32 Section: post --- @@ -38,18 +63,9 @@ Section: post On Monday, Amazon gave up on us. ``` -## Features - -+ Built with [Hugo](https://gohugo.io), on a sturdy foundation -+ Works everywhere: all modern browsers, even IE8 and later -+ You can subscribe to web notifications for status updates -+ Simple, focused, and robust design -+ Easy to edit and deploy - -## Resources +## Contribute -+ [Issue tracker](https://github.com/mistermantas/cstate) -+ [Code repository](https://github.com/mistermantas/cstate) +Feel free to open an issue or make a pull request, those should get answered pretty quickly on GitHub. ## License |