1798164 - Compile POD docs in RST format for Sphinx

Status: UNCONFIRMED

(Bugzilla :: Documentation, enhancement)

Description

[Jay Michalska [:hellcp]]

Currently docs built by docs/makedocs.pl are processed into HTML or PDF directly by the script. However that is not something Sphinx itself recognizes, so those docs are not searchable from Sphinx, and look radically different from the rest of the documentation.

There's no direct way to compile POD into RST, but it is possible to use Pod::Simple::Pandoc to convert it through Pandoc, and only then run Sphinx with the complete set of docs. This way we can have fully searchable, consistent and complete Bugzilla documentation accessible on ReadTheDocs.