<div dir="ltr"><div>+1 to pulpcore and pulp_file switching to markdown. It's quicker to write and easier to read.</div><div><br></div><div>Once a few days have passed for any concerns to be raised, if none are, then how about this for a plan?</div><div><br></div><div>1) merge your PR for pulp_file</div><div>2) verify that the docs show up on <a href="https://pulp-file.readthedocs.io/">https://pulp-file.readthedocs.io/</a> correctly</div><div>3) start into a PR to convert pulpcore documentation to markdown<br></div><div><br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Thu, Apr 30, 2020 at 3:01 PM Fabricio Aguiar <<a href="mailto:fabricio.aguiar@redhat.com">fabricio.aguiar@redhat.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr">Due issue <a href="https://pulp.plan.io/issues/6518" target="_blank">6518</a>, about documenting the python clients,<div>I searched about how to use markdown on sphinx and found this [1]</div><div>This helped me to document pulp_file client [2], currently, it introduces markdown docs from the client, keeping the pulp_file rst docs.</div><div><br></div><div>Instead of getting mixed formats for docs, </div><div>I propose we move our current docs to markdown, </div><div>please share your thoughts! </div><div><br></div><div>[1] <a href="https://www.sphinx-doc.org/en/master/usage/markdown.html" target="_blank">https://www.sphinx-doc.org/en/master/usage/markdown.html</a></div><div>[2] <a href="https://github.com/pulp/pulp_file/pull/386" target="_blank">https://github.com/pulp/pulp_file/pull/386</a><br clear="all"><div><div dir="ltr"><div dir="ltr"><div dir="ltr"><br>Best regards,</div><div dir="ltr"><span style="color:rgb(0,0,0);font-family:RedHatText,sans-serif;font-size:14px;font-weight:700;text-transform:capitalize">Fabricio</span><span style="color:rgb(0,0,0);font-family:RedHatText,sans-serif;font-size:14px;font-weight:700;text-transform:capitalize"> </span><span style="color:rgb(0,0,0);font-family:RedHatText,sans-serif;font-size:14px;font-weight:700;text-transform:capitalize">Aguiar</span><div>Software Engineer, Pulp Project</div><div><a href="https://www.redhat.com/" style="color:rgb(0,136,206);font-family:RedHatText,sans-serif;font-size:12px;margin:0px" target="_blank">Red Hat Brazil - Latam</a><br></div><div>+55 11 999652368</div><div><img src="https://marketing-outfit-prod-images.s3-us-west-2.amazonaws.com/f5445ae0c9ddafd5b2f1836854d7416a/Logo-RedHat-Email.png" width="96" height="22"></div></div></div></div></div></div></div>
_______________________________________________<br>
Pulp-dev mailing list<br>
<a href="mailto:Pulp-dev@redhat.com" target="_blank">Pulp-dev@redhat.com</a><br>
<a href="https://www.redhat.com/mailman/listinfo/pulp-dev" rel="noreferrer" target="_blank">https://www.redhat.com/mailman/listinfo/pulp-dev</a><br>
</blockquote></div>