DEV Community

Discussion on: #DEVDiscuss: Documentation Workflows

Collapse
 
jmfayard profile image
Jean-Michel 🕵🏻‍♂️ Fayard • Edited

I do all my writing in Obsidian which you use similar to Notion, but technically it's more like VS Code for writers, basically a navigator with an infinite amount of plugins.

I have already 381 files and 12k lines of text here, something I would have never expected when I started.

The main process I recommend if you want to fail spectacularly is to try to write a big article all at once until it's perfect.

Rather I recommend writing a shitty first draft, without judgement, without ever pressing the backspace key.
Later I will refactor things.

I already gave that tip from Anne Lamott, the new idea now is that ChatGPT is often perfect for generating that shitty first draft. No blank page syndrom anymore, that's a big deal.

I've discover that scheduling is really important. I would recommand to always schedule your post. It removes the pressure "is my article ready yet?". Who cares, you schedule it for Monday 09:00. You can always improve it until then. And once it's published you are not refreshing your notifications like "oh I hope someone like me and has giving me an emoji". Instead you forget about it and it's a nice comment that reminds you that indeed you have published something.

I also recommend picking a pace. For example I will try to post ever Monday at 09:00. Which pace? Every day? Every month? There is no rule except that the pace suits you. We are creature of habits so this really gets you to the next level.

But for me the biggest win was to use a Swipe File from which you pick your article ideas once you start writing. So you never again face an empty screen and ask yourself: "what I'm gonna write about today?". Instead you separate ideation from writing. If you are out in Paris walking your dog and you get a cool idea for an article --> you put in in the swipe file.

The swipe file is a concept, not an app, you can use any app for that, for example Bear(iOS), Google Keep(Android), SimpleNote(All)
The one very important rule is that you must use that note app only for that purpose.

For example with this comment, I have in fact written the More written tips idea from my swipe file :)

My final advice is that writing is great, just do it, don't worry about being bad at it when you start. It's like programming, it's all practice.

Now I just need to embed this comment in my previous writing tips article.

Collapse
 
erinposting profile image
Erin Bensinger

Rather I recommend writing a shitty first draft, without judgement, without ever pressing the backspace key.
Later I will refactor things.

This was a key learning in my creative writing education, too. I lived by the phrase "the only thing a first draft has to do is exist." Otherwise I can get so up in my head trying to perfect the details and second-guessing myself that the draft never gets done 😵‍💫