aboutsummaryrefslogtreecommitdiff
path: root/content/blog
diff options
context:
space:
mode:
authorChristian Cleberg <[email protected]>2026-05-13 14:41:45 -0500
committerChristian Cleberg <[email protected]>2026-05-13 14:41:45 -0500
commitc417506d6b35454b57abdbd222043f11e779e793 (patch)
tree7a7c806103e14de10c914e58d8801cb89b1910b6 /content/blog
parentc92a7901032a96655392b95c3a64d5322e9d454c (diff)
downloadcleberg.net-c417506d6b35454b57abdbd222043f11e779e793.tar.gz
cleberg.net-c417506d6b35454b57abdbd222043f11e779e793.tar.bz2
cleberg.net-c417506d6b35454b57abdbd222043f11e779e793.zip
fix: minor edits to latest post
Diffstat (limited to 'content/blog')
-rw-r--r--content/blog/2026-05-13-plain.org8
1 files changed, 4 insertions, 4 deletions
diff --git a/content/blog/2026-05-13-plain.org b/content/blog/2026-05-13-plain.org
index 8c58db9..a9c52a3 100644
--- a/content/blog/2026-05-13-plain.org
+++ b/content/blog/2026-05-13-plain.org
@@ -116,7 +116,7 @@ make content harder to use.
Plain text gives you portability. It does not automatically give you clarity.
-A =README= can be written in Markdown and still fail to explain what the project
+A README can be written in Markdown and still fail to explain what the project
does. A runbook can be stored in Git and still assume tribal knowledge. An audit
workpaper can be easy to archive and still fail to explain the conclusion. A
policy can be available to every employee and still be written in a way that
@@ -127,7 +127,7 @@ accessible technologically and yet, you get nothing out of it? You could re-read
it numerous times and never get an answer because the author was not focused on
accessible language.
-The file is accessible, but the meaning is not, and that matters a lot. A
+The file is accessible, but the meaning is not and that matters a lot. A
document is not useful because it exists in an open format. It is useful when
someone can read it, understand it, and act on it.
@@ -190,10 +190,10 @@ good format. You can store unclear decisions in Markdown. You can preserve vague
notes forever. You can make a document technically accessible while leaving it
practically unreadable.
-(Have you ever read a README clearly written by AI without any editing from the
+Have you ever read a README clearly written by AI without any editing from the
repository owner? It can quickly become nonsense as the AI tries to constrain
its content to the best possible README standard, while it loses any meaning of
-the project itself.)
+the project itself.
That is why plain language belongs in the same conversation.