…with an open minded approach


Documenting with Markdown, and reading it as webpage

I document my crazy projects with Markdown syntax – it uses only text, but still allows to express a rainbow of effects like *italic* **bold** bullet-lists, hierarquic headings… insert code (multiline or just short-pieces)

I began to do it using Strapdown which is a Javascript library that (among other things) parses Markdown to Html, and enables Syntax Highlight and even Bootstrap Themes (which is more than enough for my requirements)


The template I use is published as a github repo called strapdown_template and is pretty easy to use.


If its usefull to anyone else, or if you know a better way, don’t be shy and drop a comment šŸ™‚




git overview

Git is outstanding… so much that at some point,Ā it can get confusing to use it without properly understanding what is happening behind the scenes…

The best tutorial that I’ve found so far, for my level of understanding and my needs, is Vogella’sĀ Distributed Version Control with Git, which is generously available for reading online or in amazon as a kindle ebook

Also found very usefull to see theĀ interactive Git CheatSheet from NDP Software


An option I use a lot is ‘git merge –no-ff’, which does one git merge without fast-forwardingĀ  – see thisĀ discussion which explains what is the difference between a merge with fast-forward and a merge without fast-forward.Ā If you endup finally liking this option as much as I do, you can enable it for all your git merge’s, of all your projects (all of it, be aware!) by adding into your ‘~/.gitconfig’ the following:



There – hope it is asĀ usefulĀ to you as it is for me šŸ™‚