Improve message spelling in fedora-review plugin
[doc] Restructure documentation

More or less as outline suggested with slight push towards making sections
higher level
[doc] Add note about max line length
[doc] SImplify repoquery call

-q doesn't do anything
--whatprovides is equivalent to -f
[doc] Add authors of JPackage Policy document
[doc] Add intro derived from JPackage Policy
[doc] Fix a typo in Maven section
More readable (hopefully) version of xml_compare
[doc] "Packaging Maven project" section is listed twice in the index
[doc] Small fix in "Packaging Maven project"
[doc] in progress: "Java Specifics in Fedora for Users and Developers"
[doc] Assign fedora_java_packaging_specifics to mizdebsk