Bug#442029: docs should be in /usr/share/doc/opencity

[Cyril Brulebois]

severity 442029 normal
thanks

Thanasis Kinias <tkinias at kinias.org> (12/09/2007):
> There is virtually no documentation for this package; all I find is an
> English FAQ.txt and an Italian LEGGIMI.txt, both in
> /usr/share/games/opencity/docs, which is not correct per FHS.  The
> LEGGIMI.txt says it was translated by `morpheus' -- from what?  I am
> guessing that the original is French (since upstream has a Vietnamese
> name and some files have French names), but we don't have a French or an
> English README.
> 
> The package is essentially unusable without any documentation; I can
> read the Italian LEGGIMI enough to get the keystrokes down, but that
> still doesn't explain enough to make the package really usable.

How is documentation lack RC? Downgrading. I agree the description could
point to the homepage, so that one can quickly copy/paste the link and
heads to documentation. But since you look like used to documentation
location, you must know for sure that you can grab the URL from the
copyright file. And using a search engine to find a bit of documentation
shouldn't be much harder than checking for FHS violation.

Oh, and see the bug title you chose? You wrote “should”, and that's
exactly the point. Quoting the Policy 12.3:

“Any additional documentation that comes with the package may be
 installed at the discretion of the package maintainer. Plain text
 documentation should be installed in the directory
 /usr/share/doc/package, where package is the name of the package, and
 compressed with gzip -9 unless it is small.”

That's not a grave bug. If you wish to see additional things in a
package, that's even a wishlist bug, not a normal one…

Cheers,

-- 
Cyril Brulebois
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : http://lists.alioth.debian.org/pipermail/pkg-games-devel/attachments/20070913/a1e77596/attachment.pgp