Charles Plessy <ple...@debian.org> writes: > Le Tue, Sep 27, 2011 at 05:45:02PM -0700, Russ Allbery a écrit : >> Charles Plessy <ple...@debian.org> writes:
>>> - Published versions are stored in the debian-policy in >>> copyright-format/published/, as XML source and HTML and text >>> documents, without makefile as they are final versions, under names >>> like copyright-format/published/copyright-format-1.0.html. >> I think we should include the source > Yes, this is what I have written, modulo the Makefile. Yes, I know. That's just part of the overall context for my whole response which is now snipped out of that context. :) > I think that there is an advantage to not rebuild the HTML and TXT > versions, as this guarantees that the distrubuted documents on > www.debian.org will stay bit-identical. I think ensuring rebuildability is somewhat more important than this. > We can of course include a Makefile and make sure that the published > versions are always rebuildable, but if jade and links change tiny > details in the way they convert documents (whitespace,…), I think that > it would not be a good reason to change the MD5 sum of the published > versions. I guess that doesn't really bother me. >> The advantage of instead using: >> >> http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ >> >> is that, when one is using a simple mapping from URLs to file space, if >> for some reason the document ever needs to be broken into multiple >> files or needs to have images, the URL already assumes each document is >> in its own directory and keeps all those supporting files isolated from >> each other for multiple versions. > I proposed copyright-format-1.0 because it seemed to fit better David's > requirements, as for the URI you propose the file name of the spec would > be ‘index.html’. For both URIs it looks equally easy to install the > files. I will follow the WWW team's choice for sure. My assumption was that we would (for right now in the absence of needing any supporting files) generate a single HTML file named copyright-format-1.0.html, which the web team would then copy as index.html into a directory named after the version number. -- Russ Allbery (r...@debian.org) <http://www.eyrie.org/~eagle/> -- To UNSUBSCRIBE, email to debian-www-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org Archive: http://lists.debian.org/87ty7xzcs3....@windlord.stanford.edu
