David from Kodaps
banner
kodaps.bsky.social
David from Kodaps
@kodaps.bsky.social
A neuro-spicy Parisian Brit who writes about software engineering, tech communication, entrepreneurial journeys & data. I help understand code, why it is fun, & how devs think.
What do you think, are there any more that are worth mentioning and focusing on?
December 9, 2024 at 10:20 AM
TDA - Tell don't Ask (a.k.a Separation of Concerns) Business logic should be in one place. "Bits" of code should do one thing only. Keep things separate.
December 9, 2024 at 10:20 AM
YAGNI - You Ain't Gonna Need it. User needs and software specifications are fluid. Don't optimise too early. Don't away abstract concepts on the off chance another similar use case might arise one day.
December 9, 2024 at 10:20 AM
DRY - Don't repeat yourself Copy-pasting is a sure sign that things have gone wrong somewhere.
December 9, 2024 at 10:20 AM
KISS - Keep it simple : You will not recognise your own code six months from now. Keep it simple, keep it readable. Keep it clear. Don't be clever. Your future self will thank you.
December 9, 2024 at 10:20 AM
I think it'll be a while before I come to any sort of solid conclusion.
(But if you have a clear answer to this question, I'd love to hear from you!)
December 2, 2024 at 6:27 AM
To solve this question, I'm :
* building up a writing habit via the Ship30 course,
* repurposing the "atomic essay" kind of format to a short-form video.
December 2, 2024 at 6:27 AM
3 - Short form has more reach since it requires less commitment from the viewer, and I'm not using it yet. Can I use it to test ideas, or is the format too different?
December 2, 2024 at 6:27 AM
2 - I often don't know which video ideas will perform well (or not).

Packaging & the hook play a big role, too, but the subject matter is key.

But how much of a role does the subject matter (the core idea) play in short-form video? Or is it all hook & curiosity loops?
December 2, 2024 at 6:27 AM
1 - Scripting & Editing a longer-length video is time-consuming.
(And I mean very time-consuming if you want to create an engaging video.) Although... some data points favour authentic vs edited
December 2, 2024 at 6:27 AM
In Ship30for30, we learn to apply this to writing.

But I've been asking myself:

How can I apply the Lean Methodology to tech educational video content?

For three reasons:
December 2, 2024 at 6:27 AM
So next step: I'm building an MDX import / export to be able to edit my content in Payload and use my existing (MD/MDX) content.
November 30, 2024 at 7:06 AM
Payload allows you to create items containing a collection of blocks, each with its own type. For example a page with different section.

BUT surely that means my content is locked in to which ever database I'm using?
November 30, 2024 at 7:06 AM
Payload has good internationalisation (i18n) support out of the box
But more importantly...
November 30, 2024 at 7:06 AM
Payload is open-source and NextJS native. So no SaaS lock in.
It provides an administration UI for your content, but you define your content types in code (TypeScript).
November 30, 2024 at 7:06 AM
Why I'm Trying Payload :
* It's NextJS native
* It supports i18n
* It supports heterogenous blocks in a collection within an item
Allow me to explain
November 30, 2024 at 7:06 AM
I tried MDX

It is an interesting concept to augment Markdown.
It allows you to add React components to your Markdown content.

BUT if you want any substantial content, you're basically writing code in a text editor. I've not found a good way to write MDX content in Notion.
November 30, 2024 at 7:06 AM
BUT Markdown is basically only good for rich text. It's great for blog posts, but not for anything more complex on page.
November 30, 2024 at 7:06 AM
And I use Contentlayer to compile the content and convert the front matter to Typescript.

It allows me to access the front matter directly in my code.
November 30, 2024 at 7:06 AM
For now I use Markdown

I don't want my content to be locked in to a provider, e.g. a SaaS.

Markdown is portable and can be tracked with git.

So for now I use @notion.com to store my content and export it to Markdown. This allows me to have a custom front matter database.
November 30, 2024 at 7:06 AM
Follow me for more insights on communication and leadership, and news from the frontlines of software development:
https://gradient-ascent.beehiiv.com/
November 28, 2024 at 4:35 PM
November 28, 2024 at 4:35 PM