more documentation, md 2 rst