Package: debian-policy
Version: 3.5.5.0
Section 12.5 defines the location of cgi-bin executables, program
documentation and the document root, but doesn't provide any standardized
location where web applications may place files required to be available in
the document tree, but are not part of documentation.
For example, webmagick is a package to create indices of graphics in a
directory, for viewing via a web browser. The index files it creates
reference both icons, and a javascript file, if javascript was selected when
the index was made, and supported by the client browser. Lacking a better
location for these files, webmagick uses the url of /doc/webmagick/icons,
but these files are not actually part of the documentation - these are part
of the application.
Because many sites may not allow external clients to access /doc for
security reasons, files such as this, which are required for an application
to run, should be placed in a seperate location.
While I've used webmagick as an example, it's not the only application
like this. mrtg, for example, also relies on it's icons being inside the
documentation directory. Potentially, these files should be placed in a
consistent location that is seperate from any documentation, and set aside
specifically as a location for support files which need to be available via
HTTP.
--
___ ----------------------------------------------------------
' ) `\ Chirik [The Squirrel] --|-- chirik@castlefur.com
/' |_./< Chirik's Homepage is still under construction :-(
| /'-.\`|
`\ |/~\/>" A squirrel's home is really a nutcracker's suite!
`\\_<_ --[ Ascii by mustel ]----------------------------------