Post · bonfire.cafe

Hello #PyConUS! It's time for @kattni's talk: "Switching from Sphinx to Markdown"

Come join us in Ballroom B

@kattni is a Core Developer on @beeware, as well as being the Chair of @pyohio

She led the documentation migration project for #BeeWare

Starting by ack'ing that there's a shift in the MkDocs community right now; everything Kattni will be talking about will remain applicable.

Now: What is rst?
#PyConUS

rst and sphinx have been used in #Python for 20 years! It has a ton of community support, and BeeWare's docs were originally in rst using Sphinx

So what about markdown?

Markdown has been around for over a decade, and has wide support and adoption across platforms and ecosystems.

It's well-known as a format, and is now a viable alternative for rich tech docs

1+ more replies