proper markdown, docs links
better title
tuning title headers