Fixes in formatting and translation

Polish translation of document was improved (more fluent polish), lines
are kept under 80 characters per line and more structured markdown
formating