Point all 'ncm' links at corresponding 'readthedocs' pages

[GooBall]

Partially resolves quattor/quattor.github.com#128

[hpcugentbot]

Automatic reply from Jenkins: Can I test this?

[jrha]

test this please

[stdweird]

so how does this work with man as regular pod files? authconfig actually exists.
shouldn't we do this conversion in quattor/release#105?

[jrha]

A fair point. Are the component man pages actually usable or useful?

[stdweird]

useful, i'd say yes, since they contain information how the component behaves with having to read most of the code. it certainly helps when modifying methods to read what the method was supposed to do in the first place.
so for developers, it's usable, since they are reading the code anyway (assuming the pods are inlined), but to be really usable, we need quattor/release#105

if the pod format ideal for the intended usage: probably not, but it's at least a standard and it can be converted to other formats.

[jrha]

What I mean is, are they more useful as man pages or html on readthedocs? I for one have never looked at the generated man pages and I'm not sure man can even find them on our systems.

Of course the pod documentation is useful, the question is which output format we should be aiming for.

[stdweird]

@jrha they are more useful as readthedocs for sure. but that needs conversion anyway, so i would keep the pods as pods, and handle the conversion elsewhere.
if you are volunteering to rewrite all pods in whatever endformat you prefer, that's also ok. but something in between is not needed i think.