Checklist: Markdown Conversion

[SeanKilleen]

(spawned via discussion on #23)

Due to the conversion from Blogger, a lot of the posts are still in HTML format, which can cause problems:

• The formatting will be off
• They show as one long string of HTML
• Other considerations (images, code samples, etc.) have not been covered.

So we'll try to knock these out one at a time in the order of priority, since the site is live.

What we need to do for each post

When converting a post, you'll need to:

• Rename the post file from .html to .md
• HTML formatting to markdown formatting
• Save images to assets/images/posts and reference them from there
• Mark all code samples in markdown and indicate the language
• Revise to clean up in another ways as necessary
• Use {{ site.baseurl }}{% post_url 2010-07-21-name-of-post %} for links between posts
• Use ![My helpful screenshot]({{ "/assets/screenshot.jpg" | absolute_url }}) for linking to images.

We prefer many small PRs here, so tackle one or two posts at a time, and then check that post off on the list.

Prioritized List of Page Conversions

• [ ] TBD

[SeanKilleen]

@dennisdoomen you may want to add your input here over time so that others can help you work through them

[dennisdoomen]

You expect people to actually do anything here? I'll probably just convert them whenever I need to change anything.

[SeanKilleen]

You never know. :smile: I've had strangers help me when I worked in public on some of this stuff.

When I was doing this sort of thing, I used it as a checklist to keep myself straight. I added pages in order of their highest page views or other factors (images, lots of code, etc.) so that i converted the things that mattered first to my viewers.

But I was pretty interested in getting my blog to a good markdown state quickly; might be a different priority for you which is totally fine. If you're not interested in doing it that way I'd say feel free to close this issue and probably also #25. 👍

[dennisdoomen]

Well, I did notice that the Disquss comments are somehow disconnected from the converted posts.