πŸ“ We write about our technologies and the problems we handle at scale.
Switch branches/tags
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
_data Add post "Orchestrating Chaos using Grab's Experimentation Platform" (#… Nov 23, 2018
_includes Add post "The Data and Science Behind GrabShare Part I" (#14) Oct 20, 2017
_layouts consistent author links across the blog (#43) Nov 8, 2018
_plugins Add Authors feature (#6) May 17, 2017
_posts Add post "Orchestrating Chaos using Grab's Experimentation Platform" (#… Nov 23, 2018
_sass consistent author links across the blog (#43) Nov 8, 2018
css Video that maintains aspect ratio! Jun 17, 2017
fonts Port from Wordpress to Jekyll Jul 4, 2016
forms Add redirect to gamma form Aug 12, 2016
img Add post "Orchestrating Chaos using Grab's Experimentation Platform" (#… Nov 23, 2018
js Add client search functionality May 22, 2017
.gitignore Add post the-art-of-hiring-good-engineers (#12) Oct 4, 2017
.travis.yml update token (#32) Jul 12, 2018
Gemfile Remove github-pages dep (#41) Nov 2, 2018
Gemfile.lock Remove github-pages dep (#41) Nov 2, 2018
LICENSE.md Fix license Jan 31, 2018
README.md Add post "The Data and Science Behind GrabShare Part I" (#14) Oct 20, 2017
_config.yml Use https as page url Jan 31, 2018
apple-touch-icon.png Port from Wordpress to Jekyll Jul 4, 2016
authors.html consistent author links across the blog (#43) Nov 8, 2018
favicon.ico Port from Wordpress to Jekyll Jul 4, 2016
feed.json Added json feeds (#31) Jul 12, 2018
feed.xml Port from Wordpress to Jekyll Jul 4, 2016
index.html Implement categories feature Jun 8, 2017
search.html Implement categories feature Jun 8, 2017
tags.html Implement categories feature Jun 8, 2017

README.md

Grab Engineering Blog

Welcome to Grab's official engineering blog where we share the good engineering practices in Grab and the things we engineers do that can benefit other engineers in the industry. Comments and feedback are welcome!

Getting Started

The blog runs on Jekyll, an awesome static site builder that is written in Ruby. To get started, clone the repository and run the following steps:

$ gem install bundler
$ bundle install
$ bundle exec jekyll serve

Navigate to http://localhost:4000 to view the blog. A process runs in the background to watch for changes made to the code. Simply refresh the page to see the updated changes. If you are new to Jekyll, we would recommend that you check out their detailed documentation here.

Contributing

Interested in writing a blog entry to the blog? Simply fork the repository and make a pull request with the new entry, a markdown file in the _posts folder with the name YYYY-MM-DD-your-title.md.

Adding Authors

If you are a new author, add your bio to _data/authors.yml, for example:

lian-yuanlin: # This is the ID of the author
  name: Lian Yuanlin
  thumbnail: /img/authors/lian-yuanlin.jpg # Use a remote image or add your own image
  github: alienchow # GitHub Username (optional)

Writing your post

Each post should have the following front matter defined:

Property Explanation Example
layout The layout template from the _layouts directory. We only have post for now. post
id Unique id for each blog entry. This is used by Disqus to uniquely identify posts and should not be modified if a Disqus thread for that post already exists. curious-case-of-the-phantom-instance
title Title of blog entry The Curious Case of The Phantom Instance
date Date of entry in DDDD-MM-YY HH:MM:SS format 2015-12-28 04:39:00. Note that this is in UTC and posts in the future will not be displayed. To such posts during development, use bundle exec jekyll serve --future
authors YAML list of author IDs. The author bio will be retrieved from _data/authors.yml and displayed within the post. [lian-yuanlin, ...]
categories YAML list of categories, sorted alphabetically. Only use existing categories in _data/categories.yml. [Engineering]
tags YAML list of tags, sorted alphabetically. Please check existing tags on /tags and reuse where possible. [AWS, Golang]
cover_photo Relative URL to the FB open graph image (ideally 820x312) /img/grab-vietnam-careers-week/son-hai.jpg
comments Whether to display Disqus comments box. Why would you set this to false? true
excerpt Your catchy excerpt that will be shown on the list of blog entries page. Wrap your excerpt in quotes if it spans across multiple lines. "Here at the Grab Engineering team, we have built our entire backend stack on top of Amazon Web Services (AWS). Over time, it was inevitable that some habits have started to form when perceiving our backend monitoring statistics."

Proceed to write your blog entry in GitHub-flavoured Markdown format. Should you want to add images to your blog entry, the files should be added to the img/<post-id> folder.

When you are done with your entry, simply make a pull request and ping us in the #eng-bloggers Slack channel to request for a review!

That's it, happy blogging!

Deployment

Since we are using custom plugins (such as for authors), GitHub will not build and deploy the generated site for us. We use a custom gem jgd meant for deploying Jekyll pages manually.

$ jgd

This step is automatically carried out on Travis CI, you just need to commit on master to trigger the script. For more details, see the script in .travis.yml.

License

MIT License