Excessive Bold
Martin Fowler on the overuse of bold in technical writing — and how LLMs have picked up and spread this practice. The more you emphasize, the less power it has.
Read more [martinfowler.com]
Posts tagged with readability
Pipe Operator |> PHP 8.5
– acairns.co.uk - submitted by Andrew Cairns
The pipe operator will improve your code readability and composition in PHP. Understand the current approach and what future will look like.
Read more [acairns.co.uk]
Join thousands of developers
Every two weeks, I share practical tips, tutorials, and behind-the-scenes insights from maintaining 300+ open source packages.
No spam. Unsubscribe anytime. You can also follow me on X.
Benefits of writing clean, maintainable code.
– jump24.co.uk - submitted by jamie peters
We all strive to write good code when we jump onto a project but sometimes do you wonder why?
The post covers
- Why you should write clean code
- Techniques for writing cleaner code
The techniques here are useful for all level of developers and worth a quick skim over as we all nothing wrong with a quick refresher
Read more [jump24.co.uk]
Introducing tabular assertions
My colleague Seb made a cool package to write complex expectations in a readable way.
Read more [sebastiandedeyne.com]
The Source Of Readability
It's always nice to read good post on code reability.
Read more [loup-vaillant.fr]
Locality of Behaviour
– htmx.org
Locality is that characteristic of source code that enables a programmer to understand that source by looking at only a small portion of it.
Read more [htmx.org]
Explaining the code on the "Go with PHP" website
Mohamed write a nice post featuring a lot of good tips on how to make your code readable.
Read more [themsaid.com]
Avoiding one-liners in PHP
Focus on writing code that solves real problems, is well-tested, and is easy to maintain.
Read more [localheinz.com]
Locality of Behavior
– www.eloquentarchitecture.com - submitted by John Freeman
The LoB principle dictates that the behavior of a unit of code should be as obvious as possible by looking only at that unit of code. But I think something is missing from this discussion.
Read more [www.eloquentarchitecture.com]
Add Interfaces to Laravel to Increase Code Readability and Verbosity
Personally I don't know if this is a good practice, but you (and future me) might like it.
Read more [www.aaronsaray.com]
Learn how to write readable PHP that is a joy to maintain
I'm proud to announce that our new premium course on writing readable PHP is now available. It's called Writing Readable PHP.
This course contains a collection of bite-size tips (both in written form and videos) that make your code a joy to read for your co-workers and future self. These tips are aimed towards developers who know the basics of PHP and want to improve their craft. As a bonus, you'll learn to use static analysis to ensure that your code is understandable and correct.
Writing Readable PHP has been created by our team and Christoph Rumpel. It contains our combined knowledge on how to write the best PHP possible.
Improve Passing Booleans in PHP
Passing booleans to a method can be code smell, as it is not clear what a boolean does by reading the calling code.
Avoid using else
Using else often encourages complexer code structure, makes code less readable. In most cases you can refactor it using early returns.
Code that breathes
Have you ever needed to maintain a project that wasn't yours? A project that, when you first opened it, gave you chills down your spine? Even without reading the code in detail, you could already tell it was a mess.
Clever vs insightful code
We talk about cleverness as if it’s Just Bad, such as “clever code is harder to debug”. That’s going too far. Cleverness can lead to faster, safer, even clearer code.
Read more [www.hillelwayne.com]
Writing better Regular Expressions in PHP
Regular expressions are powerful, PHP but they are not known to be readable, and more often than not, maintaining a regular expression is not a straight-forward task. Here are some tips to improve and write better regular expressions in PHP.
Read more [php.watch]
Greatly improve the readability of your code by breaking down complex conditionals
Most developers have probably seen some complex conditionals in legacy code. In this video I show you how to refactor those.
Improving readability by decreasing indentation
Readability of code can be vastly improved by decreasing indentation. In this video we'll reverse conditions and early returns to accomplish this. If you want to see more videos like this one, head over to the video section at Spatie.
On using arrow functions in PHP 7.4
In PHP 7.4 a widely requested feature landed: arrow function. In this blogpost I'd like to show you how I like to use them.
Writing readable PHP: decrease indentation by returning early
In this short post, I'd like to give you a tip on writing readable PHP.