Adding Prettier to a Project
Add Prettier with a pre-commit hook and dedicate one commit to a full reformat
Build that blog already
What's holding you back from starting your blog? Sort through the real issues from the noise and start today.
This week I held a mini-workshop called Let's build and deploy your blog already. It was unexpectedly popular. I suspect this is because as humans, we all tend to procrastinate, and workshops are a great opportunity to finally get that to-do checked off.
I am a freelance developer and performance engineer. I now get more new clients from conversions on my blog than through word of mouth. It took a long time to get here, but you'll never arrive if you never start.
So what's holding you back from starting that tech blog? Don't know where to start? Feel like everything needs to be perfect first? In this post, I'll give you a few tips for making those brave first steps.
So many tools are out there, what if I pick the wrong one? #
Popular tools come and go like the wind. My advice is to pick the one that will be the easiest for you to consistently blog. Secondarily, if you like tinkering, consider how you like interacting and customizing that tool.
Don't worry about whether it's the hottest new framework. You won't get a job based on which framework you used to build your blog. You'll get a job because you're actually writing interesting content on your blog. Content is king, not the framework.
Some things to consider when selecting tools:
- Make sure it's in a language you like. Don't pick a Ruby-based tool if you prefer JavaScript.
- Consider how easy it is to build and deploy.
- Consider user experience, including performance. If you're loading a giant JavaScript bundle for your framework that means a longer load time for your readers.
For me, Eleventy paired with Netlify checks all the right boxes. It's JavaScript-based but sends no client-side JavaScript to the browser. I can write HTML, Markdown, Nunjucks, and many other templating languages. Build times are fast, and deploying with Netlify only requires a git push to GitHub. That's me though - find the tool that will work best for you.
No one will read my posts unless they're on [insert platform here], right? #
Yes and no. You might not have a lot of readers in the beginning. That's totally fine. The numbers will come in time. The good news is you don't have to pick hosting your own blog over posting on Dev.to or other platforms. You can do both. This is called syndication.
Sometimes platforms die, and if you only have your content hosted there, you can lose it all.
To properly syndicate without an SEO penalty, you need to set the canonical URL both on your original post and on syndicated copies. If you inspect the <head> tag on any page on my blog, you'll see its corresponding canonical URL meta tag:
<link rel="canonical" href="https://sia.codes/posts/itsiest-bitsiest-eleventy-tutorial/">In Eleventy, I can programmatically set this in my base layout like so:
<link rel="canonical" href="https://sia.codes{{ page.url }}">Other tools should have similar capabilities.
You also need to set the canonical URL on other publishers when you copy your posts there. Each one is different, but I'll highlight Dev.to here. Dev is very canonical-URL friendly.
To set the canonical URL, when you're editing the post, you'll see a small hexagonal button next to the "Save changes" button. Click the hexagon to get to the canonical URL settings.
Eventually, learn more about SEO and optimize the timing on when you syndicate. In the beginning, you don't need to worry about it.
But I want dark mode, social share images, a great design, etc. #
Feature wishlist creep can hold you back from accomplishing anything. I know because I've been there.
Just build and deploy a minimally-viable-blog (MVB). Like right now. Today. If you don't, you'll never be motivated enough to improve it. Let the shame work to your advantage.
Forms #
Many of us want a way for people to be able to contact us through our website. As a woman in tech, I don't necessarily want to share my email address so openly. In the old days, we would need a server or a third-party widget to handle contact forms.
Today, Netlify includes form handling for up to 100 submissions per month for free! Implementing it is mostly setting a netlify attribute on the form then setting up notifications in Netlify:
<form name="contact" method="POST" netlify>Netlify automatically filters out most spam, and you can add a honeypot field to help filter out bots. Check out the docs for more info.
Conclusion #
Your blog isn't the goddess Athena. It's not going to pop fully formed and all grown up out of your head. You aren't Zeus.
Stop procrastinating, and build your minimally-viable-blog today. Yes, today! Deploy it! Yes, right now! Before you close that tab!
You might also like
My adventures in turning a Pixelbook into a developer machine
With the Chromebook Linux beta, web development got a whole lot easier.
How to build a website in 2021
It's really easy.
Webmentions
If you liked this article and think others should read it, please share it.
❤️ 17
🔁 6
💬 5
Brian Cooley
"Just build and deploy a minimally-viable-blog (MVB). Like right now. Today. If you don't, you'll never be motivated enough to improve it. Let the shame work to your advantage." I love this. Great read. source
Sia Karamalegos
Lol thanks source
Sergey Chernyshev
The hard part is to write words in that blog… I truly admire your efforts on both doing technology and educating people about it! source
Sia Karamalegos
Aww thanks! So true. I think 80% of what I write is to have a resource to go back to when I forget how to do something 😅 source
Binyamin Green
I love that idea. Write for yourself, then publish for others. source
These are webmentions via the IndieWeb and webmention.io. Mention this post from your site: