Removed recommonmark from docs build #457
Conversation
|
Just a minor fix needed due to flake failure. Do you have a snapshot of the before and after of the documentation? Was wondering if they look the same or if they look different when using m2r as opposed to recommonmark. |
|
Attached are couple comparisons between my local files and what's on Readthedocs currently. I couldn't tell a difference.
|
|
@eemperor This looks good, the docs are generating properly. One more thing to look into would be to switch as much of the rst syntax over to md syntax as we can. Things like: Can become: And, also, the two |
eemperor
force-pushed
the
ripout-recommonmark
branch
from
6f74132 to
340b8ab
Compare
|
@lorengordon I updated the link references to markdown format. I changed the rst files to md but left the directive that pulls in markdown files from the parent directory. Seems like a clean way to reference the associated markdown files. |
| @@ -21,7 +21,7 @@ to looking for pypi packages signed with MD5 signatures. If you've enabled FIPS | |||
| (or are using a build that has FIPS pre-enabled), MD5 is disabled in the kernel | |||
| (due to being a weak hashing-method). You can either disable FIPS (not | |||
| recommended) or explicitly force `pip` to use a different signature-index. The | |||
| latter is detailed in the Linux section of the :doc:`usage <usage>` document. | |||
| latter is detailed in the Linux section of the [usage] (usage.html) document. | |||
There was a problem hiding this comment.
Oops, got a space in there between the bracket and paren: ] (
Open a new pr to fix?
| @@ -52,7 +52,7 @@ label may not be related to the error you are encountering. | |||
|
|
|||
| ## Does watchmaker support Enterprise Linux 7? | |||
|
|
|||
| Watchmaker is supported on RedHat 7 and CentOS 7. See the :doc:`index <index>` | |||
| Watchmaker is supported on RedHat 7 and CentOS 7. See the [index] (index.html) | |||
Removed recommonmark from the docs build and updated associated markdown files to directly use the existing restructuredtext format.