search

2i2c-org / upstream

A place to keep track of upstream issues that we'd like to work on.
0 stars 0 forks source link

Create content for a blog post for the section "Myst support for roles and directives" #34

Closed damianavila closed 2 years ago

damianavila commented 3 years ago

The idea of this ticket is to track the creation of content and eventually publish a blog post about Myst support for roles and directives. Check #14 if you need a bigger context.

The proposed outline looks like this (for now, this is evolving content):

Myst support for roles and directives

How it is now...

Why do we want to go independent from docutils/sphinx?

Discuss possible implementations

Steps:

damianavila commented 3 years ago

I am currently at ~50 % on part 2 and it is already complex/heavy for the reader. We will definitely need a part 3.

damianavila commented 2 years ago

Update: I think I will have the draft ready for the first review by today/tomorrow.

damianavila commented 2 years ago

This is the draft: https://github.com/damianavila/blog/pull/5

@choldgraf can you please take a look and provide feedback, thanks!!

choldgraf commented 2 years ago

done! by the way, I have a PR to support external posts here: https://github.com/2i2c-org/2i2c-org.github.io/pull/63

damianavila commented 2 years ago

by the way, I have a PR to support external posts here: 2i2c-org/2i2c-org.github.io#63

I will take a look soon!

Btw, @choldgraf, I have one more question for you in my blog post proposal. Appreciated it if you can check it again 😉 .

damianavila commented 2 years ago

PR was merged and the blog post published: https://damianavila.github.io/blog/posts/a-deep-dive-into-myst-part-2-the-myst-parser-docutils-and-sphinx.html

Closing here!