[Python-modules-team] musicbrainzngs package in debian (re: bug #698202)

Jonas Smedegaard dr at jones.dk
Wed Apr 17 13:57:18 UTC 2013


Quoting Alastair Porter (2013-04-17 13:56:27)
> I have one question about adding documentation to the package. Is it 
> easier for you as a packager to have documentation sources, or the 
> compiled html, or does it not matter? I'm not too sure what the best 
> practises are around this.

As upstream you should ideally release for the whole World to consume.  
Large distributions like Debian often have needs that makes sense to 
adapt to, but in this case I believe that it is best for you to ship not 
only sources for documentation but actual human-readable documentation - 
even if we for Debian choose to regenerate documentation.

(this is similar to use of e.g. automake and autoconf).


Regards,

 - Jonas

-- 
 * Jonas Smedegaard - idealist & Internet-arkitekt
 * Tlf.: +45 40843136  Website: http://dr.jones.dk/

 [x] quote me freely  [ ] ask before reusing  [ ] keep private



More information about the Python-modules-team mailing list