The Mediocre Programmer

This book is about helping you along on the journey of being a mediocre programmer. Together we'll uncover some of common misconceptions we have about programming, failure, and growth and come to understand that the act of programming and development is something we undertake each day and improve in small ways. It's these small changes that over time transform us from being mediocre programmers into better programmers.

· · tootstream · 3 · 29 · 24

Boosts appreciated, reading the book highly sought after, patches welcome.

Huge thanks to @davidrevoy for his amazing cover artwork for this book. Absolutely stunning. Thank you.

@craigmaloney I might fuck around and add a little bit of CSS to the HTML version. More than anything, to add margins, or maybe simply limit the maximum width of the lines (they pretty hard to read right now).

Would you accept a patch like that?

@estebanm Absolutely. I wasn't sure how best to add it because I'm generating them using pandoc, so if it can integrate with pandoc I'm totally for it.


@craigmaloney Yeah, I saw there's (as I imagined) a command-line option to add a CSS file when you convert to HTML.

Ok, this is a first version of it:

I don't know if there's a way to make a Merge Request between different GitLab instances, so I just hosted it on my Gitea. If there is a way to make MRs between GitLab instances I can use next time.

@estebanm Made a new origin and merged the branch. It looks so much better. Thank you so much! I really appreciate it.

@craigmaloney My pleasure! And I even learned something useful on the way, hehe. Everybody wins!

@craigmaloney Hm, I think it looks nicer without the underline in the header links (but keeping the link colour, of course). If you agree, this rule does it:
h1 a, h2 a, h3 a {
text-decoration: none;

@estebanm I'm a little reluctant to remove underlining from links (even header links) because the underline can aid in accessibility. That said, if folks want to add those to their copies of the HTML I'm all for it. I don't want to have too heavy of a hand on the HTML version. :)

@craigmaloney Not trying to convince you, but I'm curious what you mean by aiding in accessibility.

First of all, in case it wasn't clear, I mean only the headers and not the table of contents (which I think is ok with underline, and will be untouched by the rules I suggested). I think underlined headers are very ugly and even if they are links in this case, they are not really used to navigate.

Also, the colour & cursor will stay so I think it's reasonably clear that they're still links 😄

@estebanm Right, I get that. However, it is also a signal to someone that it is a link and if they click on it there's an anchor there. The only reason to remove them is aesthetics, so I'm not inclined to remove them, as it is also a clickable link. Thanks, though!

Sign in to participate in the conversation

The social network of the future: No ads, no corporate surveillance, ethical design, and decentralization! Own your data with Mastodon!