Archive for the ‘Interesting’ Category

MkDocs – Project documentation with Markdown.

November 2, 2017 Leave a comment

MkDocs is a fast, simple and downright gorgeous static site generator that’s geared towards building project documentation. Documentation source files are written in Markdown, and configured with a single YAML configuration file.

Categories: Interesting

Semantic Versioning 2.0.0

October 30, 2017 Leave a comment


Given a version number MAJOR.MINOR.PATCH, increment the:

MAJOR version when you make incompatible API changes,
MINOR version when you add functionality in a backwards-compatible manner, and
PATCH version when you make backwards-compatible bug fixes.

Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format.

Categories: Interesting

Building and Packaging a Python command-line tool for Debian

October 27, 2017 Leave a comment

Python packaging has a chequered past.

Distutils was and still is the original tool included with the standard library. But then setuptools was created to overcome the limitations of distutils, gained wide adoption, subsequently stagnated, and a fork called distribute was created to address some of the issues. Distutils2 was an attempt to take the best of previous tools to support Python 3, but it failed. Then distribute grew to support Python 3, was merged back in to setuptools, and everything else became moot!

Unfortunately, it’s hard to find reliable information on python packaging, because many articles you might find in a Duckduckgo search were created before setuptools was reinvigorated. Many reflect practices that are sub-optimal today, and I would disregard anything written before the distribute merge, which happened in March 2013.

While which packaging tool to use was ambiguous in the past, it’s now much easier to recommend one. At the time of writing (September 2016), you should use setuptools. It’s what most packages use, is fully supported by pypi and pip, and works pretty well. For a summary of the subject of python packaging tools, this page summarises them all very well. For an authoritative reference, see

Categories: debian, Interesting, python


October 13, 2017 Leave a comment

vagrant-hostmanager is a Vagrant plugin that manages the hosts file on guest machines (and optionally the host). Its goal is to enable resolution of multi-machine environments deployed with a cloud provider where IP addresses are not known in advance.

Categories: Interesting

Create a VM instance on Google cloud

October 5, 2017 Leave a comment

Google cloud platform aka GCP is a cloud offering from Google. GCP frees you from the overhead of managing infrastructure, provisioning servers and configuring networks. To let innovators innovate and let coders, well, just code. In this blog post, we’ll get to know how to create a VM instance on GCP. First of all, you’ll need […]

via Create a VM instance on Google cloud —

Categories: Interesting

GOTO 2015 • Agile is Dead • Pragmatic Dave Thomas

September 6, 2017 Leave a comment

Categories: Interesting

Talks DevOps

September 4, 2017 Leave a comment

DevOpsDays Portland, 2016: Kelsey Hightower – NoOps

Kelsey Hightower – Keynote – Pycon 2017

Categories: Interesting Tags: ,