From 4bc818712d9b0133dd22326052a99ef1f36f4aa0 Mon Sep 17 00:00:00 2001 From: Mantas Date: Mon, 23 Oct 2017 18:56:13 +0300 Subject: Slightly better docs --- README.md | 48 ++++++++++++++++++++++++++++++++---------------- 1 file changed, 32 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index fe716ad..bff5f6f 100644 --- a/README.md +++ b/README.md @@ -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 -- cgit v1.2.3-70-g09d2