Composition in Action: Finishing the Swing
In software engineering, what look to be the easy parts often turn out to be the hard parts. If you’re lucky, the reverse is also true, but don’t count on it.
Posts by Topic
- projects 11
- design 10
- typescript 10
- principles 8
- javascript 8
- writing 6
- karmic-rules 6
- documentation 6
- jekyll 5
- project-governance 5
- template 5
- nextjs 4
- logging 4
- dynamodb 4
- react 3
- troubleshooting 3
- ai 3
- github 2
- ethics 2
- testing 2
- agile 2
- bali 2
- npm 2
- aws 2
- vs-code 2
- redux 1
- web3 1
- events 1
- funny 1
- serverless 1
- autohotkey 1
- windows 1
- atlassian 1
- offshoring 1
projects
Mixin It Up: Picking The Right Problem to Solve
Sometimes, when you’re tangled up in a thorny problem, solving it is exactly the wrong answer.
Loggable: A TypeScript Mixin for Generic Class Logging
Logging is an implementation decision that should be deferred as late as possible. Loggable lets you defer it until runtime!
Code Complete: A Day in the Life of a Product
We’re all professionals here, right? And we all know there’s often quite a gap between what gets posted to social media and the reality on the ground.
mock-db
Mock DynamoDB-style query & scan behavior with local JSON data. Or learn to play the guitar, if you think pretty girls REALLY like that kind of thing.
dot-code for Windows
An AutoHotKey script that launches VS Code with the open folder or selected files in File Explorer when you type Alt-Win-.
Next.js Template
A sweet Next.js project template. Integrates Redux Toolkit with with test support for Mocha + Chai + React Testing Library and release publishing via release...
AWS API Template
Config-driven AWS API ES6 template integrating federated Cognito User Pool authentication and a robust approach to release management.
React Component NPM Package Template
An ES6 React component NPM package project template featuring front & back end test support, automated API docs, release management & more!
NPM Package Template
An ES6 NPM package project template featuring a CLI, test support, automated API docs, release management & more!
Testing Redux in NextJS
If you’re testing ES6 code referencing Redux in a transpiled build environment, you can save yourself a lot of trouble by putting your tests into JSX files.
design
Design as Code: A Frictionless Low-Level Design Pipeline
A frictionless low-level design process that integrates with your dev cycle and puts design artifacts at a peer level with the rest of your codebase.
Turning the Crank: Design as a Mechanical Process
What a good design artifact looks like, what they’re actually for, and how to use them efficiently to achieve a better outcome for your project.
Composition in Action: Finishing the Swing
In software engineering, what look to be the easy parts often turn out to be the hard parts. If you’re lucky, the reverse is also true, but don’t count on it.
Mixin It Up: Picking The Right Problem to Solve
Sometimes, when you’re tangled up in a thorny problem, solving it is exactly the wrong answer.
Loggable: A TypeScript Mixin for Generic Class Logging
Logging is an implementation decision that should be deferred as late as possible. Loggable lets you defer it until runtime!
Code Complete: A Day in the Life of a Product
We’re all professionals here, right? And we all know there’s often quite a gap between what gets posted to social media and the reality on the ground.
What Good Looks Like: A Real-World Typescript Refactor
Watch a complex Javascript configuration object collapse into declarative goodness thanks to type safety, abstraction, and generic design.
Karmic Rule Five
generic logic + custom config ≫ custom logic – Karmic Rules for Writing Pretty Good Code
Karmic Rule Three
If you want to get a complex process right, template it. – Karmic Rules for Writing Pretty Good Code
Karmic Rule Zero
Minimize external dependencies and try not to use shitty libraries. – Karmic Rules for Writing Pretty Good Code
typescript
Composition in Action: Finishing the Swing
In software engineering, what look to be the easy parts often turn out to be the hard parts. If you’re lucky, the reverse is also true, but don’t count on it.
Mixin It Up: Picking The Right Problem to Solve
Sometimes, when you’re tangled up in a thorny problem, solving it is exactly the wrong answer.
Loggable: A TypeScript Mixin for Generic Class Logging
Logging is an implementation decision that should be deferred as late as possible. Loggable lets you defer it until runtime!
Code Complete: A Day in the Life of a Product
We’re all professionals here, right? And we all know there’s often quite a gap between what gets posted to social media and the reality on the ground.
What Good Looks Like: A Real-World Typescript Refactor
Watch a complex Javascript configuration object collapse into declarative goodness thanks to type safety, abstraction, and generic design.
Generic Abstractions
Modern software development works just like any other Hero’s Journey: you’ve got to hoof it some ways down the road before you can see very far into the dist...
Radash: The New Lodash
If you use Typescript and are still using Lodash: stop. It’s time for a change Give Radash a try!
mock-db
Mock DynamoDB-style query & scan behavior with local JSON data. Or learn to play the guitar, if you think pretty girls REALLY like that kind of thing.
TSDoc + TypeDoc
Mastering the obvious, one lexical standard at a time.
When IntelliSense Fails: How to Avoid TypeScript While Avoiding TypeScript
Sure you could transpile perfectly good ES6 code into the same thing + TS types. But sweet mother of everything, WHY??
principles
Composition in Action: Finishing the Swing
In software engineering, what look to be the easy parts often turn out to be the hard parts. If you’re lucky, the reverse is also true, but don’t count on it.
Mixin It Up: Picking The Right Problem to Solve
Sometimes, when you’re tangled up in a thorny problem, solving it is exactly the wrong answer.
Karmic Rule Five
generic logic + custom config ≫ custom logic – Karmic Rules for Writing Pretty Good Code
Karmic Rule Four
A work in progress is the best kind. – Karmic Rules for Writing Pretty Good Code
Karmic Rule Three
If you want to get a complex process right, template it. – Karmic Rules for Writing Pretty Good Code
Karmic Rule Two
Nothing raises issues like contact with reality. – Karmic Rules for Writing Pretty Good Code
Karmic Rule One
Troubleshooting works just like the regular kind: you won’t hit your target if you don’t have one. – Karmic Rules for Writing Pretty Good Code
Karmic Rule Zero
Minimize external dependencies and try not to use shitty libraries. – Karmic Rules for Writing Pretty Good Code
javascript
Lodash + Next.js 13 = smh
Some old carelessness in Lodash plus a stern new outlook in Next.js 13 creates trouble on Edge networks.
When IntelliSense Fails: How to Avoid TypeScript While Avoiding TypeScript
Sure you could transpile perfectly good ES6 code into the same thing + TS types. But sweet mother of everything, WHY??
Next.js Template
A sweet Next.js project template. Integrates Redux Toolkit with with test support for Mocha + Chai + React Testing Library and release publishing via release...
AWS API Template
Config-driven AWS API ES6 template integrating federated Cognito User Pool authentication and a robust approach to release management.
React Component NPM Package Template
An ES6 React component NPM package project template featuring front & back end test support, automated API docs, release management & more!
NPM Package Template
An ES6 NPM package project template featuring a CLI, test support, automated API docs, release management & more!
Vercel Preview Branch Weirdness
An accidental hosting environment dependency revealed an irritating bug in Vercel’s preview deployment logic.
Unexpected Mutations
An unexpected (and probably unintended) function parameter mutation inside the web3.js library had me questioning my sanity for a couple of hours.
writing
Unifying Web Presence with GitHub Pages
Eliminate content collisions with your primary GitHub Pages domain & unify all your GitHub project documentation pages under a single subdomain.
Idea Discovery on GitHub
Coming up with ideas is easy. Deciding which ones to execute on is HARD. Here’s a kitchen-sink approach using engagement as a metric of market potential.
Some Words on LinkedIn
Squaring the impossible circle: Where should your content actually live?
AI-Generated Social Media Previews
I’ve generally been underwhelmed by ChatGPT and the like. Fun toy: not much practical use, so far. But this is an exception!
Hello World! (Redux)
Rediscovering blogging. Again.
Hello (Again) World!
You spend years of perfectly good writing time building gilded prisons for your words. If only there were a simple, beautiful way to write PORTABLE words.
karmic-rules
Karmic Rule Five
generic logic + custom config ≫ custom logic – Karmic Rules for Writing Pretty Good Code
Karmic Rule Four
A work in progress is the best kind. – Karmic Rules for Writing Pretty Good Code
Karmic Rule Three
If you want to get a complex process right, template it. – Karmic Rules for Writing Pretty Good Code
Karmic Rule Two
Nothing raises issues like contact with reality. – Karmic Rules for Writing Pretty Good Code
Karmic Rule One
Troubleshooting works just like the regular kind: you won’t hit your target if you don’t have one. – Karmic Rules for Writing Pretty Good Code
Karmic Rule Zero
Minimize external dependencies and try not to use shitty libraries. – Karmic Rules for Writing Pretty Good Code
documentation
Composition in Action: Finishing the Swing
In software engineering, what look to be the easy parts often turn out to be the hard parts. If you’re lucky, the reverse is also true, but don’t count on it.
Mixin It Up: Picking The Right Problem to Solve
Sometimes, when you’re tangled up in a thorny problem, solving it is exactly the wrong answer.
Unifying Web Presence with GitHub Pages
Eliminate content collisions with your primary GitHub Pages domain & unify all your GitHub project documentation pages under a single subdomain.
Code Complete: A Day in the Life of a Product
We’re all professionals here, right? And we all know there’s often quite a gap between what gets posted to social media and the reality on the ground.
TSDoc + TypeDoc
Mastering the obvious, one lexical standard at a time.
Hello World! (Redux)
Rediscovering blogging. Again.
jekyll
Related Posts With Minimal Mistakes
Presenting a radically improved related-posts widget for the Minimal Mistakes Jekyll theme.
Unifying Web Presence with GitHub Pages
Eliminate content collisions with your primary GitHub Pages domain & unify all your GitHub project documentation pages under a single subdomain.
Some Words on LinkedIn
Squaring the impossible circle: Where should your content actually live?
Hello World! (Redux)
Rediscovering blogging. Again.
Hello (Again) World!
You spend years of perfectly good writing time building gilded prisons for your words. If only there were a simple, beautiful way to write PORTABLE words.
project-governance
Design as Code: A Frictionless Low-Level Design Pipeline
A frictionless low-level design process that integrates with your dev cycle and puts design artifacts at a peer level with the rest of your codebase.
Turning the Crank: Design as a Mechanical Process
What a good design artifact looks like, what they’re actually for, and how to use them efficiently to achieve a better outcome for your project.
Git Flow By Example: Writing Down Your Version Control Process
If you haven’t written down your project’s version control process in all its unique glory, then you don’t have one!
A Modern Agile Project Manifesto
A battle-tested, all-inclusive starting point for a modern Agile project.
Karmic Rule Two
Nothing raises issues like contact with reality. – Karmic Rules for Writing Pretty Good Code
template
TSDoc + TypeDoc
Mastering the obvious, one lexical standard at a time.
Next.js Template
A sweet Next.js project template. Integrates Redux Toolkit with with test support for Mocha + Chai + React Testing Library and release publishing via release...
AWS API Template
Config-driven AWS API ES6 template integrating federated Cognito User Pool authentication and a robust approach to release management.
React Component NPM Package Template
An ES6 React component NPM package project template featuring front & back end test support, automated API docs, release management & more!
NPM Package Template
An ES6 NPM package project template featuring a CLI, test support, automated API docs, release management & more!
nextjs
Lodash + Next.js 13 = smh
Some old carelessness in Lodash plus a stern new outlook in Next.js 13 creates trouble on Edge networks.
Next.js Template
A sweet Next.js project template. Integrates Redux Toolkit with with test support for Mocha + Chai + React Testing Library and release publishing via release...
Vercel Preview Branch Weirdness
An accidental hosting environment dependency revealed an irritating bug in Vercel’s preview deployment logic.
Testing Redux in NextJS
If you’re testing ES6 code referencing Redux in a transpiled build environment, you can save yourself a lot of trouble by putting your tests into JSX files.
logging
Composition in Action: Finishing the Swing
In software engineering, what look to be the easy parts often turn out to be the hard parts. If you’re lucky, the reverse is also true, but don’t count on it.
Mixin It Up: Picking The Right Problem to Solve
Sometimes, when you’re tangled up in a thorny problem, solving it is exactly the wrong answer.
Loggable: A TypeScript Mixin for Generic Class Logging
Logging is an implementation decision that should be deferred as late as possible. Loggable lets you defer it until runtime!
Lodash + Next.js 13 = smh
Some old carelessness in Lodash plus a stern new outlook in Next.js 13 creates trouble on Edge networks.
dynamodb
Loggable: A TypeScript Mixin for Generic Class Logging
Logging is an implementation decision that should be deferred as late as possible. Loggable lets you defer it until runtime!
Code Complete: A Day in the Life of a Product
We’re all professionals here, right? And we all know there’s often quite a gap between what gets posted to social media and the reality on the ground.
What Good Looks Like: A Real-World Typescript Refactor
Watch a complex Javascript configuration object collapse into declarative goodness thanks to type safety, abstraction, and generic design.
mock-db
Mock DynamoDB-style query & scan behavior with local JSON data. Or learn to play the guitar, if you think pretty girls REALLY like that kind of thing.
react
Next.js Template
A sweet Next.js project template. Integrates Redux Toolkit with with test support for Mocha + Chai + React Testing Library and release publishing via release...
React Component NPM Package Template
An ES6 React component NPM package project template featuring front & back end test support, automated API docs, release management & more!
Testing Redux in NextJS
If you’re testing ES6 code referencing Redux in a transpiled build environment, you can save yourself a lot of trouble by putting your tests into JSX files.
troubleshooting
Lodash + Next.js 13 = smh
Some old carelessness in Lodash plus a stern new outlook in Next.js 13 creates trouble on Edge networks.
Vercel Preview Branch Weirdness
An accidental hosting environment dependency revealed an irritating bug in Vercel’s preview deployment logic.
Karmic Rule One
Troubleshooting works just like the regular kind: you won’t hit your target if you don’t have one. – Karmic Rules for Writing Pretty Good Code
ai
AI-Generated Social Media Previews
I’ve generally been underwhelmed by ChatGPT and the like. Fun toy: not much practical use, so far. But this is an exception!
TSDoc + TypeDoc
Mastering the obvious, one lexical standard at a time.
Poodle Wars: A Conversation with ChatGPT
Love letters to killer poodles. An artificially intelligent exploration into the depths of the ridiculous.
github
Unifying Web Presence with GitHub Pages
Eliminate content collisions with your primary GitHub Pages domain & unify all your GitHub project documentation pages under a single subdomain.
Installing GitHub Repo Template Updates
Your project depends on a GitHub repo template that has released a new version. How do you integrate the changes?
ethics
Karmic Rule Two
Nothing raises issues like contact with reality. – Karmic Rules for Writing Pretty Good Code
Why Intent Trumps Action
Intent matters more than even massive action, because in the long term it is more effective at actually getting the job done.
testing
mock-db
Mock DynamoDB-style query & scan behavior with local JSON data. Or learn to play the guitar, if you think pretty girls REALLY like that kind of thing.
Testing Redux in NextJS
If you’re testing ES6 code referencing Redux in a transpiled build environment, you can save yourself a lot of trouble by putting your tests into JSX files.
agile
A Modern Agile Project Manifesto
A battle-tested, all-inclusive starting point for a modern Agile project.
Karmic Rule Two
Nothing raises issues like contact with reality. – Karmic Rules for Writing Pretty Good Code
bali
Betting on Bali: My Journey Into the Offshoring Business
I’m laying down a big bet on Bali! Let me share the evidence that has inspired me to take this leap. Maybe it will inspire you to jump in with me!
How to Run an Event That Doesn’t Suck
Distilling 18 months of experience with 80+ online events, involving thousands of attendees, down into a letter to a friend.
npm
React Component NPM Package Template
An ES6 React component NPM package project template featuring front & back end test support, automated API docs, release management & more!
NPM Package Template
An ES6 NPM package project template featuring a CLI, test support, automated API docs, release management & more!
aws
Lodash + Next.js 13 = smh
Some old carelessness in Lodash plus a stern new outlook in Next.js 13 creates trouble on Edge networks.
AWS API Template
Config-driven AWS API ES6 template integrating federated Cognito User Pool authentication and a robust approach to release management.
vs-code
When IntelliSense Fails: How to Avoid TypeScript While Avoiding TypeScript
Sure you could transpile perfectly good ES6 code into the same thing + TS types. But sweet mother of everything, WHY??
dot-code for Windows
An AutoHotKey script that launches VS Code with the open folder or selected files in File Explorer when you type Alt-Win-.
redux
Testing Redux in NextJS
If you’re testing ES6 code referencing Redux in a transpiled build environment, you can save yourself a lot of trouble by putting your tests into JSX files.
web3
Unexpected Mutations
An unexpected (and probably unintended) function parameter mutation inside the web3.js library had me questioning my sanity for a couple of hours.
events
How to Run an Event That Doesn’t Suck
Distilling 18 months of experience with 80+ online events, involving thousands of attendees, down into a letter to a friend.
funny
Poodle Wars: A Conversation with ChatGPT
Love letters to killer poodles. An artificially intelligent exploration into the depths of the ridiculous.
serverless
AWS API Template
Config-driven AWS API ES6 template integrating federated Cognito User Pool authentication and a robust approach to release management.
autohotkey
dot-code for Windows
An AutoHotKey script that launches VS Code with the open folder or selected files in File Explorer when you type Alt-Win-.
windows
dot-code for Windows
An AutoHotKey script that launches VS Code with the open folder or selected files in File Explorer when you type Alt-Win-.
atlassian
A Modern Agile Project Manifesto
A battle-tested, all-inclusive starting point for a modern Agile project.
offshoring
Betting on Bali: My Journey Into the Offshoring Business
I’m laying down a big bet on Bali! Let me share the evidence that has inspired me to take this leap. Maybe it will inspire you to jump in with me!