help documentation packaging locations

[Dave M]

Hello all,

(Disclaimer: I'm both upstream and maintainer for a project)

Question regarding location of help documentation:  I'm going to start
including help documentation with a program.  In doing research for
packaging tips, there's both /usr/share/gnome/help/$package and
/usr/share/help/$locale.  The vast majority are located under the
former.

However, I came across this bug report
(https://bugzilla.redhat.com/show_bug.cgi?id=736523) which states that
Gnome has moved to packaging documentation under the latter option.
It also includes how the rpm spec will handle the documentation files.

As a still novice packager, is this bug report and its rpm spec a good
example to use?  Just want to make sure I have everything in order
since it's a big change for a pretty basic rpm spec.

(Also, I noticed Debian seems to put everything under
/usr/share/gnome/help/$package.  Not a concern for this mailing list,
but it's something for me to keep in mind as I package debs for this
too).

Thanks for any guidance,
Dave M