README rewrite dev docs
included a default pillar file
markdown docs
improve these docs link on every page