Serverless Blog

Welcome to the serverless blog repo! Contributions, typo fixes and pull requests are welcome 👍

Submitting content
Adding author details
Markdown resources

How to contribute content:

Click here to add a post or submit a new pull request via the command line.
Write your content in markdown!
Name your post file name in this format YYYY-MM-DD-blog-post-name.md 👉 2016-01-27-post-title-here.md handy tool for this
In your post, include the required post information:

Include the post metadata at the top:

---
title: My awesome post title
description: "This post is about awesome stuff!"
date: 2016-05-25
thumbnail: 'http://url-to-thumbnail.jpg'
layout: Post
authors:
  - FirstnameLastname
---

Then write your post ⬇️ Github flavored markdown is supported!

# Post Heading

This is an awesome paragraph!

## Post SubSection

[Link example](http://my-full-url-with-http-at-the-front.com)

* List item 1
* List item 2
* List item 3

```js
// code snippet example with javascript (js) syntax highlighting
console.log('JS code')
```

Questions about formatting? See a complete post example

Aligning images

`left` alignment

This is the code you need to align images to the left:

<img align="left" width="100" height="100" src="http://www.fillmurray.com/100/100">

`right` alignment

This is the code you need to align images to the right:

<img align="right" width="100" height="100" src="http://www.fillmurray.com/100/100">

`center` alignment example

<p align="center">
  <img width="460" height="300" src="http://www.fillmurray.com/460/300">
</p>

Once your post is ready to go, add your author info, submit a PR to the repository.

We will review and publish your post with our audience on serverless.com and share it all around the web!

Ping us with any questions on Twitter or post an issue and we will get back with you shortly.

Curious about what your post will look like on the live site? You can preview your post by cloning down the site repo, installing the dependencies and running npm start.

How to add Author Information

Click here to add Author information

The name of the file should be the same as the name field used in the blog post meta data. Format: FirstnameLastname (note the caps and no space!)

Example authors/DavidWells.json and DavidWells in the authors field below are the same name and capitalization.

---
layout: Post
title: David's Amazing Post
authors:
 - DavidWells # references data in authors/DavidWells.json file
---

Including Custom Scripts

Note: For security purposes, all scripts referenced are vetted and hosted via our s3 bucket.

If you need to include a custom script for demo purposes, you will need to send the script over to us for review.

# blog post frontmatter
layout: Post
title: David's Amazing Post
scripts:
  - https://link-to-custom-js-in-s3-bucket.js
  - http://link-to-custom-js-two-in-s3-bucket.js
inlineJS: |
  console.log('hi')
  console.log('this is a multiline inline JS that will run in the post')

Markdown Resources

Our blog posts are written in markdown and support standard Github flavored markdown. If you are new to markdown, don't fret, check out this handy how to guide on writing in markdown

Need a markdown editor? Give stackedit.io, Byword or typora a spin.

Need to convert a Google doc to markdown? Install this chrome extension

Need to convert HTML to markdown? You can use this handy html to markdown converter

Need to convert Word to markdown? You can use this handy Word to Markdown Converter

Recommended Writing Apps

hemingwayapp - Hemingway helps you write with power and clarity by highlighting adverbs, passive voice, and dull, complicated words.

kenthunt/blog