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 Nikola" #33

Closed damianavila closed 3 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 Nikola. Check #14 if you need a bigger context.

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

A deep dive into the MyST world

First impressions

Current limitations

Understanding the limitations

Overcome the limitations (invitation to next part)

Steps:

damianavila commented 3 years ago

PR with the draft lives here: https://github.com/damianavila/blog/pull/4

@choldgraf, I would appreciate it if you can take a look and provide feedback!

Btw, we have not decided about the first item:

Choose where we are going to publish (Damián's blog, some EBP blog, EBP post linking Damián's post)

My idea was to publish it on my blog and linking it in the EBP blog section (a la Quantstack), WDYT?

choldgraf commented 3 years ago

I just took a pass through the text and left some comments, thanks @damianavila

For where to post it - I think that content makes more sense on a personal blog rather than on the EBP blog, since it's more about your experience using the tools rather than about the tools themselves.

I'm not sure how we can cross-post using ablog, so for now let's just post this on your blog and we can try to figure out how to make an external post list on the EBP blog later

damianavila commented 3 years ago

@choldgraf updated the blog post draft, I would appreciate it if you can make another pass on it. Thanks!!

damianavila commented 3 years ago

PR is ready, I just need to convert it to ipynb and publish it.

Publishing on Monday afternoon (I do not like to publish on Fri afternoon when everyone is closing their computers 😉).

damianavila commented 3 years ago

Published here: https://damianavila.github.io/blog/posts/a-deep-dive-into-myst-part-1-the-myst-parser-python-api-usage-in-nikola.html