ipip-383: deduplicate content, editorial cleanup

improves the flow of the document, hints are described only once now (3x
before) in a single place, table of contents is easy to glance at
and follows the flow of the file syntax

Author: lidel