Publish new post checklist


This is my checklist for publishing a new post on my blog:

Preparation

  • Finalize the posts name and sluggify it
  • Pick a image if fitting
  • Create a new post with hugo new content/posts/<slug of post>.md
  • Move the draft from my current writing tool to this new file
  • Fill in the generated front matter template
  • If the post is ~1.000+ words enable the TOC
  • Run spell-check in VSCode and fix things

Proofing

  • Run local hugo server hugo server -bind=0.0.0.0
  • Wait at least an hour
  • Open the locally served page on the iPad, grab a cup of tea and read it
  • Make last changes and typo fixes as needed
  • Place a `

` comment to get a good and readable preview in lists on the page (no code blocks, etc)

Publishing

  • git commit & git push
  • Wait for CI to publish the post
  • Write a pitch-line for social posts
  • Open the post on the live page at https://blog.marco.ninja and check that it looks alright
  • Submit post to be indexed by Google in the search console https://search.google.com/search-console
  • Post the link to LinkedIn with the pitch-line
  • Go over to https://dev.to, the post should already show up there (RSS pull), polish and publish it there too

Notes

Dear future Marco, you’re probably thinking I could automate most of this!. And while you probably could, please keep this in mind: https://xkcd.com/1319/

See also