This repository contains tutorials of RunAbove Knowledge base.
Help the community benefit from all of RunAbove’s power, and earn RunAbove credit to take your own project even further! The process is quick, easy, and we’re open to your suggestions.
Anyone can submit a how-to guide for review via GitHub. If you don’t already have a GitHub account, you can create one for free.
Diversity is at our core and we’re open to a huge range of subjects. Keep in mind that that RunAbove users are devs or devops, so a how-to guide on making Runabove products work seamlessly with popular technologies/stacks/services would be a perfect angle.
Simply fork the runabove/knowledge-base project on our GitHub page. Create a new page under /en/_posts and using markdown to write your how-to guide. Please refer to the metadata in existing guides so that you add adequate metadata at the beginning of your guide. Feel free to create a folder for your images in /images.
The existing guide categories are development, network, and object storage. If you don’t think your guide falls under any of these, don’t hesitate to suggest a new one - we’ll take it into consideration.
When you’re done, launch a pull request for your fork. Once we’ve received your guide, we will review it against our criteria, and either accept it or reject it. You’ll hear back from us as soon as possible, we may ask you to do some modifications to your guide. If we merge your fork, we’ll give you a voucher for $100 for you to use with RunAbove!
Please note that we may not accept your how-to guide if it doesn’t fit our review criteria. Here is a list of some of the main points we’ll take into account:
- Your guide is written in English.
- Any prerequisites for carrying out the steps in the guide are listed in your guide’s intro.
- Any usage you encourage is completely legal and respects good practices and security standards.
- Content is your own and doesn’t include any copyrighted content (including images). Your proposal should be exclusively published on our website.
Please also keep in mind that we’re mainly interested in how-to guides on open-source tools and integration with popular tier technologies.
If you want to talk to us about your fork, please get in touch with us on our
IRC channel: #runabove on Freenode.
Fork runabove/knowledge-base repository and get the content on your machine.
git clone https://github.com/your_github_username/knowledge-base.git
Add a file inside posts directory with this template:
---
layout: post
title: "My first tutorial"
categories: Instances
author: your_github_username
lang: en
---
# Here you can add your tutorial
With markdown syntax.To deploy tutorials on runabove, we use a python tool called Jekyll. You can find more informations about Jekyll installation inside the official documentation. For example on Debian 7, installation instructions are:
apt-get install ruby1.9.3 rubygems nodejs
gem install jekyllInside root directory of the project, you can run this command to generate the website and see your guide:
jekyll buildYou website is now inside _site directory.
When your tutorial is ready, create a pull request on GitHub. Then we will review your tutorial. If that's your first tutorial, to benefit of your RunAbove credit, we need to get TOS signed by your hand (picture of the document). After, we merge it and the website is automatically updated.