src/content/: Tweak asciidoc leftovers

10 files changed, 35 insertions, 32 deletions

diff --git a/src/content/blog/2018/07/17/guix-nixos.adoc b/src/content/blog/2018/07/17/guix-nixos.adoc
index aa42e4b..b9cd89b 100644
--- a/src/content/blog/2018/07/17/guix-nixos.adoc
+++ b/src/content/blog/2018/07/17/guix-nixos.adoc
@@ -162,7 +162,7 @@ guix-daemon = {
 };
 ----
 
-There you go! After running `sudo nixos-rebuild switch` I could get Guix up and
+There you go!  After running `sudo nixos-rebuild switch` I could get Guix up and
 running:
 
 [source,bash]
diff --git a/src/content/blog/2020/08/31/database-i-with-i-had.adoc b/src/content/blog/2020/08/31/database-i-with-i-had.adoc
index 7533c8a..443a54e 100644
--- a/src/content/blog/2020/08/31/database-i-with-i-had.adoc
+++ b/src/content/blog/2020/08/31/database-i-with-i-had.adoc
@@ -5,7 +5,9 @@
 :haskell-startup: https://www.youtube.com/watch?v=ZR3Jirqk6W8
 
 I watched the talk "{values-talk}[Platform as a Reflection of Values: Joyent,
-Node.js and beyond]" by Bryan Cantrill, and I think he was able to put into words something I already felt for some time: if there's no piece of software out there that reflects your values, it's time for you to build that
+Node.js and beyond]" by Bryan Cantrill, and I think he was able to put into
+words something I already felt for some time: if there's no piece of software
+out there that reflects your values, it's time for you to build that
 software{empty}footnote:talk-time[
   At the very end, at time 29:49.  When talking about the draft of this article
   with a friend, he noted that Bryan O'Sullivan (a different Bryan) says a
diff --git a/src/content/blog/2020/10/20/wrong-interviewing.adoc b/src/content/blog/2020/10/20/wrong-interviewing.adoc
index 89f93b8..b673262 100644
--- a/src/content/blog/2020/10/20/wrong-interviewing.adoc
+++ b/src/content/blog/2020/10/20/wrong-interviewing.adoc
@@ -130,16 +130,16 @@ huge productivity boost is to give them a touch typing course.  If they are so
 productive with typing speed being a limitation, imagine what they could
 accomplish if they had razor sharp touch typing skills?
 
-Also, why stop there? A good touch typist can do 90 WPM (words per minute), and
+Also, why stop there?  A good touch typist can do 90 WPM (words per minute), and
 a great one can do 120 WPM, but with a stenography keyboard they get to 200
-WPM+.  That is double the productivity! Why not try
-{speech-to-text}[speech-to-text]? Make them all use {j-lang}[J] so they all need
-to type less!  How come nobody thought of that?
+WPM+.  That is double the productivity!  Why not try
+{speech-to-text}[speech-to-text]?  Make them all use {j-lang}[J] so they all
+need to type less!  How come nobody thought of that?
 
 And if someone couldn't solve the programming puzzle in the given time window,
 but could come back in the following day with an implementation that is not only
 faster, but uses less memory, was simpler to understand and easier to read than
-anybody else? You'd be losing that person too.
+anybody else?  You'd be losing that person too.
 
 === IQ
 
@@ -178,11 +178,11 @@ it's a non-differential signaling question.
 ____
 
 Stretching it, this is a rather snobbish view of HR.  Why is it that an intern
-in HR can't make signaling questions? Could the same be said of an intern in
+in HR can't make signaling questions?  Could the same be said of an intern in
 engineering?
 
 In other words: is the question not signaling because the one asking is from HR,
-or because the one asking is an intern? If the latter, than he's just arguing
+or because the one asking is an intern?  If the latter, than he's just arguing
 that interns have no place in interviewing, but if the former than he was
 picking on HR.
 
@@ -192,7 +192,7 @@ only see them as inferiors doing unpleasant work, and who aren't capable enough
 
 This is equivalent to people who work primarily on backend, and see others
 working on frontend struggling and say: "isn't it just building views and
-showing them on the browser? How could it possibly be that hard?  I bet I could
+showing them on the browser?  How could it possibly be that hard?  I bet I could
 do it better, with 20% of code".  As you already know, the answer to it is
 "well, why don't you go do it, then?".
 
@@ -270,13 +270,13 @@ proposal isn't sound enough to not become one.
 Even if the ideas were good, they aren't solid enough, or based on solid enough
 things to make them stand out by themselves.  Why is it that talent, judgment
 and personality are required to determine the fitness of a good candidate?  Why
-not 2, 5, or 20 things? Why those specific 3?  Why is talent defined like that?
+not 2, 5, or 20 things?  Why those specific 3?  Why is talent defined like that?
 Is it just because he found talent to be like that?
 
 Isn't that definitionally also
 {cult}[cargo-culting]footnote:cargo-cult[
   {cult-archived}[Archived version].
-]? Isn't he just repeating whatever he found to work form him, without
+]?  Isn't he just repeating whatever he found to work form him, without
 understanding why?
 
 What Feynman proposes is actually the opposite:
@@ -314,13 +314,13 @@ about technical hiring?
 What studies were performed on the different success rate of interviewing
 strategies?  What have they done right and what have they done wrong?
 
-What is the purpose of HR? Why do they even exist? Do we need them, and if so,
+What is the purpose of HR?  Why do they even exist?  Do we need them, and if so,
 what for?  What is the value they bring, since everybody insist on building an
-HR department in their companies? Is the existence of HR another form of cargo
+HR department in their companies?  Is the existence of HR another form of cargo
 culting?
 
-What is industrial and organizational psychology? What is that field of study?
-What do they specialize in? What have they learned since the discipline
+What is industrial and organizational psychology?  What is that field of study?
+What do they specialize in?  What have they learned since the discipline
 appeared?  What have they done right and wrong over history?  Is is the current
 academic consensus on that area?  What is a hot debate topic in academia on that
 area?  What is the current bleeding edge of research?  What can they teach us
diff --git a/src/content/blog/2020/11/08/paradigm-shift-review.adoc b/src/content/blog/2020/11/08/paradigm-shift-review.adoc
index dd31f87..7dd4f78 100644
--- a/src/content/blog/2020/11/08/paradigm-shift-review.adoc
+++ b/src/content/blog/2020/11/08/paradigm-shift-review.adoc
@@ -148,6 +148,6 @@ Rich Hickey makes a great case for single-process FP on his famous talk
 
 ////
 I find this conclusion too short, and it doesn't revisits the main points
-presented on the body of the article. I won't rewrite it now, but it would be an
-improvement to extend it to do so.
+presented on the body of the article.  I won't rewrite it now, but it would be
+an improvement to extend it to do so.
 ////
diff --git a/src/content/blog/2020/11/12/database-parsers-trees.adoc b/src/content/blog/2020/11/12/database-parsers-trees.adoc
index eed785b..1d5770c 100644
--- a/src/content/blog/2020/11/12/database-parsers-trees.adoc
+++ b/src/content/blog/2020/11/12/database-parsers-trees.adoc
@@ -181,7 +181,7 @@ I think the best way to get there is by taking the existing code for cbindgen,
 which uses the {syn-crate}[syn] crate to parse the Rust
 code{empty}footnote:rust-syn[
   The fact that syn is an external crate to the Rust compiler points to a big
-  warning: procedural macros are not first class in Rust. They are just like
+  warning: procedural macros are not first class in Rust.  They are just like
   Babel plugins in JavaScript land, with the extra shortcoming that there is no
   specification for the Rust syntax, unlike JavaScript.
 FIXME
diff --git a/src/content/blog/2020/11/14/local-first-review.adoc b/src/content/blog/2020/11/14/local-first-review.adoc
index 0dd3bea..420c886 100644
--- a/src/content/blog/2020/11/14/local-first-review.adoc
+++ b/src/content/blog/2020/11/14/local-first-review.adoc
@@ -1,4 +1,4 @@
-= Local-First Software: You Own Your Data, in spite of the Cloud - article review
+= Local-First Software: article review
 
 :empty:
 :presentation: link:../../../../slides/2020/11/14/local-first.html
@@ -78,8 +78,8 @@ license expiration allowed.  Sure you could change the clock on the computer,
 but there are many other ways that this type of intentional restriction is in
 conflict with that ideal.
 
-However, what about unintentional restrictions? What if a software had an equal
-or similar restriction, and stopped working after days pass? Or what if the
+However, what about unintentional restrictions?  What if a software had an equal
+or similar restriction, and stopped working after days pass?  Or what if the
 programmer added a constant to make the development simpler, and this led to
 unintentionally restricting the user?
 
@@ -152,8 +152,8 @@ local-first solutions that already exist.
 
 Say the automerge CRDT proves to be even more useful than what everybody
 imagined.  Say someone builds a local-first repository service using it.  How
-will it change anything of the Git/GitHub model? What is different about it that
-prevents people in the future writing a paper saying:
+will it change anything of the Git/GitHub model?  What is different about it
+that prevents people in the future writing a paper saying:
 
 ____
 In principle it is possible to collaborate without a repository service, e.g. by
@@ -197,8 +197,8 @@ Well, I disagree.
 
 The problem isn't inherit to the web platform, but instead how people use it.
 
-I have myself built offline-first applications, leveraging IndexedDB, App Cache, _etc_.  I wanted to build an offline-first application on the web, and so I
-did.
+I have myself built offline-first applications, leveraging IndexedDB, App Cache,
+_etc_.  I wanted to build an offline-first application on the web, and so I did.
 
 In fact, many people choose {pouchdb}[PouchDB] _because_ of that, since it is a
 good tool for offline-first web applications.  The problem isn't really the
diff --git a/src/content/blog/2021/02/17/fallible.adoc b/src/content/blog/2021/02/17/fallible.adoc
index 533e107..e8dc8f6 100644
--- a/src/content/blog/2021/02/17/fallible.adoc
+++ b/src/content/blog/2021/02/17/fallible.adoc
@@ -133,7 +133,7 @@ my own code, but was still left with manually verifying the correctness and
 robustness of it.
 
 How could I add assertions around my code that would help me make sure the
-`free(s1);` exists, before getting an error report? How do other people and
+`free(s1);` exists, before getting an error report?  How do other people and
 projects solve this?
 
 From what I could see, either people a) hope for the best, b) write safe code
diff --git a/src/content/slides/2020-11-14-on-local-first-beyond-the-crdt-silver-bullet.slides b/src/content/slides/2020-11-14-on-local-first-beyond-the-crdt-silver-bullet.slides
index 33fc239..8f17982 100644
--- a/src/content/slides/2020-11-14-on-local-first-beyond-the-crdt-silver-bullet.slides
+++ b/src/content/slides/2020-11-14-on-local-first-beyond-the-crdt-silver-bullet.slides
@@ -201,7 +201,7 @@ Why not exploit that more?
 
 > The architecture of web apps remains fundamentally server-centric
 
-Disagree. Contrast [PouchDB][pouchdb] with Android [Instant Apps][instant-apps]
+Disagree.  Contrast [PouchDB][pouchdb] with Android [Instant Apps][instant-apps]
 
 [pouchdb]: https://pouchdb.com/
 [instant-apps]: https://developer.android.com/topic/google-play-instant
@@ -236,7 +236,7 @@ connection
 ### On CRDTs and developer experience
 
 > For an app developer, how does the use of a CRDT-based data layer compare to
-> existing storage layers like a SQL database, a filesystem, or CoreData? Is a
+> existing storage layers like a SQL database, a filesystem, or CoreData?  Is a
 > distributed system harder to write software for?
 
 Yes.
diff --git a/src/content/tils/2020/09/05/oldschool-pr.adoc b/src/content/tils/2020/09/05/oldschool-pr.adoc
index c1c56b7..020861e 100644
--- a/src/content/tils/2020/09/05/oldschool-pr.adoc
+++ b/src/content/tils/2020/09/05/oldschool-pr.adoc
@@ -17,7 +17,7 @@ clone of the repository, what do you think about bringing those in?".
 
 The only difference is that you’re working with only Git itself, so you’re not
 tied to any Git hosting provider: you can send pull requests across them
-transparently! You could even use your own {cgit}[cgit] installation.  No need
+transparently!  You could even use your own {cgit}[cgit] installation.  No need
 to be locked in by any of them, putting the "D" back in "DVCS": it’s a
 *distributed* version control system.
 
diff --git a/src/content/tils/2020/12/15/shellcheck-repo.adoc b/src/content/tils/2020/12/15/shellcheck-repo.adoc
index 960812e..e86cbff 100644
--- a/src/content/tils/2020/12/15/shellcheck-repo.adoc
+++ b/src/content/tils/2020/12/15/shellcheck-repo.adoc
@@ -23,7 +23,8 @@ run ShellCheck on.
 
 This first version worked fine, as all my scripts had the `.sh' ending.  But I
 recently added some scripts without any extension, so `assert-shellcheck.sh`
-called for a second version.  The first attempt was to try grepping the shebang line:
+called for a second version.  The first attempt was to try grepping the shebang
+line:
 
 [source,shell]
 ----
@@ -123,7 +124,7 @@ scripts/songbooks.in
 scripts/with-container.sh
 ----
 
-Great! Only `TODOs.org` is missing, but the script is much better: instead of
+Great!  Only `TODOs.org` is missing, but the script is much better: instead of
 matching against any part of the file that may have a shebang-like line, we only
 look for the first.  Let's put it back into the `assert-shellcheck.sh` file and
 use `NULL` for separators to accommodate files with spaces in the name: