[Pkg-nagios-devel] Bug#659900: icinga-cgi: documentation should be moved to the icinga-doc package

[Michael Friedrich]

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.friedrich at 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