2023-07-26 #event-sourcing

Granular events

When building a CRUD interface in an event sourced system, you'll come across the dilemma of how granular your events should be. Should you have a large PostUpdated event, or granular TitleUpdated, ContentUpdated, and AuthorUpdated events?

Read more

2023-07-21 #the-web / rachelandrew.co.uk

Rachel Andrew: 'Stop treating all of your content as if it were news'

Personal websites are often blogs these days: a chronological stream of thoughts, news, and articles. However, some content is worth more than a post stuck and lost in time.

If I need to publish content about an emerging API, I need a couple of things. I need reference documentation so that people who want to try it out understand how to use it. This reference is evergreen content, and I will update it as the API changes. It is helpful to have, right up front, information about the last time we updated the content and the version of the spec, or browser to use for testing. I also want to let people know that we’ve shipped this experiment, so I need a news post pointing to my reference material, explaining that this thing is here, and asking people to try it out and give us some feedback. I will not update the news post; what I might do, however, is write another news post when the spec and implementation changes to let people know the progress. These news posts are my paper trail.

Food for thought for my own site. I have a bunch of old articles I wish were more discoverable as pages outside of the "blog" format.

2023-07-21 #laravel #spatie

Some geeky frontend notes on the Full Stack Artisan website

At Laracon US we announced we're working on a new course at Spatie: Full Stack Artisan.

In Full Stack Artisan, we'll dive into building Laravel applications with Inertia, React, TypeScript, view models, our Laravel Data package, and more.

Last week I took a break from working on course content to set up branding and a landing page.

Read more

2023-07-19 #technology / projecteink.com

E-ink newspaper artwork

What a lovely project! Project E-Ink builds a large e-ink display that displays the front page of the newspaper.

I have a strong attraction towards e-ink. I think it's because despite being state of the art technology, e-ink doesn't feel "digital". In the case of this display: it's there, it's connected, but it's static. It's up to date but doesn't grab your attention.

2023-07-19 #the-web / adactio.com

Jeremy Keith: 'With AI, tech has broken the web’s social contract'

Jeremy Keith has an interesting take on how AI affects how we interact with search engines as content creators.

Previously, Google had a mutually beneficial agreement with websites: websites provided content, and Google brought traffic. Now, Google is using our content to generate and host their own.

2023-07-18 #programming

Explore the other side & learn a new language

If you want to become a better programmer, my number one advice is to learn another programming language. The further away from your comfort zone the better.

Read more

2023-07-17 #php #php-unit #testing

Beware of PHPUnit data providers with heavy setup methods

Data providers can be a perfect fit to assert a lot of expectations without writing a full test for each, but they can slow down your tests unnecessarily.

Read more

2023-07-04 #javascript / frantic.im

JavaScript Gom Jabbar

You stop to count how many tools and parsers work on your codebase: TypeScript, esbuild, swc, babel, eslint, prettier, jest, webpack, rollup, terser. You are not sure if you missed any. You are not sure if you want to know. The level of pain is so high you forget about anything else.

We've come a long way, but we're not there yet.

2023-07-02 #the-web #blogging

Blogs, more than ever

It's been an odd few days with the changes on Reddit and Twitter – the only two major social media platforms I browse.

Platforms are great portals for discovery, but a guarantee for longevity is not their strong suit. And while the fediverse is interesting, my Mastodon experience feels more like a detox than something that stands on its own.

Read more

2023-06-28 #product-management / www.productplan.com

Fibonacci estimates

Estimating software projects will never be my strong suit, but I've learned using numbers from the Fibonacci sequence to judge the size sets me off to a good start.

To estimate a task (in hours or days), I only use numbers from the Fibonacci sequence:

1, 2, 3, 5, 8, 13, 21, 34, 55…

The further along the Fibonacci sequence, the bigger the difference with the next number becomes. This aligns well with how we should estimate, because the bigger the task, the more unknowns there are.

2023-06-28 #blogging / www.henrikkarlsson.xyz

A blog post is a very long and complex search query to find fascinating people and make them route interesting stuff to your inbox

A lovely essay by Henrik Karlsson on writing, blogging, and the power of the internet.

When writing in public, there is a common idea that you should make it accessible. This is a left over from mass media. Words addressed to a large and diverse set of people need to be simple and clear and free of jargon. […]

That is against our purposes here. A blog post is a search query. You write to find your tribe; you write so they will know what kind of fascinating things they should route to your inbox. If you follow common wisdom, you will cut exactly the things that will help you find these people.

2023-06-27 #css #mailcoach / mailcoach.app

How I built customizable themes using CSS custom properties & HSL

I published an article on the Mailcoach blog explaining the setup around customizable themes for newsletter archives.

I relied on CSS custom properties and HSL colors to allow users to customize their newsletter archives without fiddling with too many options.

Colors are often defined in RGB, but RGB is difficult to transform without custom functions. We ask the user to define the primary color in HSL instead. The benefit of HSL is that it's easy to control a color by tweaking the parameters.

2023-06-27 #php #php-wishlist

PHP wishlist: Nested properties

Next on my PHP wishlist are nested properties. This idea is less realistic than others, it's more me thinking out loud. I don't have a good syntax proposal for this, and I'm not even sure it's the best solution for my problem. But it's the best I've come up with so far.

Read more

2023-06-21 #event-sourcing / www.youtube.com

Event sourcing on PHP Annotated

I had the pleasure to have a conversation with Brent on PHP Annotated about event sourcing.

We talked about event sourcing in general, benefits, difficulties, and how we're using it in production.

2023-06-20 #the-web #progressive-enhancement / adactio.com

Read-only web apps

From Jeremy Keith:

Your app should work in a read-only mode without JavaScript. Without JavaScript I should still be able to read my email in Gmail, even if you don’t let me compose, reply, or organise my messages.

I like this take on progressive enhancement. JavaScript is the language for interactivity on the web. Reading does not require two-way communication.