On 14.02.2012 18:10, Christoph Anton Mitterer wrote:
Package: icinga-cgi
Version: 1.6.1-2
Severity: wishlist


Hi.

I see no real reason why the documentation was actually put in icinga-cgi,
while icinga-doc is merely a dummy package with some symlinks.

docs are pure html viewable docs, and no manpages or similar. so keeping this within the web package, is truly correct.



It should actually be vice versa. Or even better, thre should be no symlink


Not every icinga instance needs to publish the documentation and users
might just choose not to do so.
This is right now not possible.
if you don't require the docs, you would have to edit the static menu.html entry - which is forbidden by policy, if icinga-htmldocs would touch icinga-cgi's menu.html then - sourcing from your proposal.

furthermore, by just removing the docs directory, this link will remain dead/broken, and that's even more an issue for the majority of the users.




Best would be if the /usr/share/icinga/htdocs/docs would go away, or contain
a html with a link to the upstream doc.

not everyone got his/her icinga instance fully connected to the internet, at least not loading basic http(s) from outbound. making this the default is just plain wrong and circumvents every intention providing offline docs.




If a user really wants to serve the documentation himself. He can still
install the doc package, an put according Alias definitions in place.

if $user really got a problem with the docs,

# vim /usr/share/icinga/htdocs/menu.html

<!--
<li class="menuli_style2">
<div class="flag">Documentation
<a class="flag" href="docs/de/index.html" target="main"><img src="docs/images/flags/de.png" /></a><a class="flag" href="docs/en/index.html" target="main"><img src="docs/images/flags/um_gb.png" /></a>
</div>
</li>
                        -->

# rm -rf /usr/share/icinga/htdocs/docs





Chris.





--
DI (FH) Michael Friedrich

Vienna University Computer Center
Universitaetsstrasse 7 A-1010 Vienna, Austria

email:     michael.friedr...@univie.ac.at
phone:     +43 1 4277 14359
mobile:    +43 664 60277 14359
fax:       +43 1 4277 14338
web:       http://www.univie.ac.at/zid
           http://www.aco.net

Lead Icinga Core Developer
http://www.icinga.org




--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org

Reply via email to