A developers portal, in the open. For developers at Sky (past, present and future) and by developers at Sky.

Great! You really should and it's easy to do. Don't get put off if you've never done this sort of thing before.

You'll need to do a little bit of work with github as our approval process uses the standard github pull request process.

For those familiar with git and github pull requests, skip forward to installing jekyll.

• Create a github account if you don't have one. Any standard github account will do, you don’t need special permissions

• Ensure you're running a git client then ensure you've set it up

• Fork our repository and clone it to your machine.

• Install Jekyll if you want to preview your blog post. If you don’t want to preview, then don’t worry about Jekyll. On a machine with RubyGems, it's super quick

gem install jekyll

• Run jekyll from within your cloned project

jekyll serve

• Create a new file in the _posts directory. Every file represents a post. Each file should take the format YYYY-MM-DD-.markdown. As an example “2015-04-13-hello-world”

• Open the file and include the following header

---
layout: post
title:  “title”
date:   YYYY-MM-DD HH:MM:SS
categories: blog category
image: a link to an image to be used
excerpt: “An excerpt you want to appear in the blog summary screen”
---

An example is as follows:-

---
layout: post
title:  "Sky at Google I/O"
date:   2015-05-12 08:52:19
categories: conferences
image: images/test.png
excerpt: "Sky are attending Google I/O - here's what we're planning to see any why"
---

• Write your awesome post using standard markup. See the examples or documentation. If you're running Jekyll, the site will automatically update on saving your post.

• Add, commit and push your post

• Create a pull request into master. Then wait for it to be merged. It will automatically appear on developers.sky.com once merged.

Images can either be served from an external location (in which case, include the full url). Alternatively, add them to the “images” directory. They’ll then appear in images/