Bad references should be reported instead of being ignored silently

[jwage]

Right now if some docs have a reference to a page that doesn't exist, it just silently ignores it and leaves an empty href.

[SenseException]

With the usage of doctrine/rst-parser #233, unknown references result in an unknown anchor now. How should the reporting look like? Should there be an output in the console?

[jwage]

It silently ignores the bad reference right now and outputs the unknown reference link in the HTML. @weaverryan and I have talked about adding a feature to doctrine/rst-parser that would let you throw an exception if a bad reference is encountered.

[SenseException]

That would be the (unresolved) case. So the plan is to make the build of the docs fail on a unresolvable reference?

[jwage]

Yes. That is my current thought.