TE
TechEcho
Home24h TopNewestBestAskShowJobs
GitHubTwitter
Home

TechEcho

A tech news platform built with Next.js, providing global tech news and discussions.

GitHubTwitter

Home

HomeNewestBestAskShowJobs

Resources

HackerNews APIOriginal HackerNewsNext.js

© 2025 TechEcho. All rights reserved.

Ask HN: Interested on writing a book on software design/architecture together?

30 pointsby jakobovover 2 years ago
Hey there..<p>I have started writing a book on software design&#x2F;architecture that provides a different perspective than existing books out there. The thesis of the book is that &quot;code is for humans&quot;. The book explains how to write code that is optimal for our primitive monkey brains. The book describes how many of the best practices in software stem from deficiencies in our cognitive abilities. It expands on best practices such as (DRY, SSOT, etc) and brings new ideas on what is good code and how to write it.<p>I am looking for someone to partner with on this book as it&#x27;s a huge project and I would love to be able to split the work.<p>I have written a rough outline and filled in about 40 pages of notes, examples and text. The project is still very much in it&#x27;s infancy.<p>A bit about me: I worked as the software architect of a 100+ person team at Mobileye&#x2F;Intel and have many, many years of experience working on a variety of software from self driving cars to web apps.

12 comments

smoochyover 2 years ago
I may. I wrote a book once. Hard work. I think you may need an editor, rather than a co-author. Someone who&#x27;d proofread and rearrange every sentence of every paragraph of every page of every chapter. And do it 10 or more times for each of those sentences, paragraphs, pages and chapters - before it can be published even as beta. Furthermore, as we all know, senior engineers disagree vastly on so many tiny little things: preferences, practices, routines, while simultaneously agreeing on some deeper inherent truths. But keeping that in mind, co-authoring may work out kinda like Rustin Cohle and Marty Hart worked out in True Detective - in the end. Question is, what kind of journey are you up for. And where am I.<p>Drop me a line, the email is on my website orion3.space
mionover 2 years ago
Congratulations on the work! I’ve been doing startups for +10 years but also worked in big companies. This is pretty interesting, how do we contact you?<p>One thing I really wish I had learned from a book is how to adapt the architecture to the current stage the company is in (something like this likely exists but IDK).<p>For instance, the “brittleness” of your systems must follow the “certainty” the company has on product-market fit. In other words, if the % of changing code is high then it should be cheap to change it. I could explain this in much more detail, and I have seen countless under-engineering and over-engineering issues in practice because people lack this mental model.
quickthrower2over 2 years ago
Something that I would find useful along these lines is: how does a team with a legacy codebase which may not be nice for human in many places pay down the tech debt?<p>Most companies have tightly couple code, only partial test coverage and slow build times (builds bloat until the pain is too painful and it is reigned in but that is too far)<p>There is a technical and a social aspect to this. Telling the boss we will ship fewer features etc. as we are doing stuff for future maintainers and better on boarding.
verdagonover 2 years ago
This is a perspective I&#x27;ve been following and cultivating for a long time, and even led to my current endeavor [0]. Code should really be structured to be easy for us humans to understand and change, and we humans are sometimes not as logical as we&#x27;d like to believe.<p>It can sometimes feel like a lot of folks are chasing other priorities and forget to even consider the human aspect of architecture. I also often see people make mistakes on what &quot;simplicity&quot; is, and what kind of simplicity should be optimized for. For a recent example, Rust&#x27;s borrow checker is based on a simple rule (roughly, a reference can have one mutable reference xor multiple readonly reference) but it can often lead to more complexity than the corresponding program written in a GC&#x27;d language. Knowing when and how this happens is an art!<p>I&#x27;m not sure if I have anything you haven&#x27;t thought of already, but I&#x27;d love to contribute a chapter or two on whatever topic, or edit anything that needs editing. If you&#x27;d like a sample of my work, I&#x27;m particularly proud of [1]!<p>[0] <a href="https:&#x2F;&#x2F;vale.dev&#x2F;" rel="nofollow">https:&#x2F;&#x2F;vale.dev&#x2F;</a><p>[1] <a href="https:&#x2F;&#x2F;verdagon.dev&#x2F;blog&#x2F;yak-shave-language-engine-game" rel="nofollow">https:&#x2F;&#x2F;verdagon.dev&#x2F;blog&#x2F;yak-shave-language-engine-game</a>
eimrineover 2 years ago
Hi! I am considering myself as a generalist, that means jack of all trades but master of none. I do not work as a programmer and never did but I love to study computer sciences.<p>I think your book with best practices also must contain something about TDD, Lisp macroses vs C++ ones, some bits of knowledge on system programming, and how software makes our world worse because of abandoning engineer culture in craft of software development. I do not think I can be a co-author, but I might help you if you have some interdisciplinary questions or if you need somebody to read your drafts.<p>English is not my mother language so do not expect great writing skills from me but if you have some unanswered questions from fields of general knowledge I will do my best to let your project be as good as you have claimed.
评论 #32564618 未加载
aaronblohowiakover 2 years ago
I would strongly suggest you read this classic paper “programming as theory building” <a href="https:&#x2F;&#x2F;pages.cs.wisc.edu&#x2F;~remzi&#x2F;Naur.pdf" rel="nofollow">https:&#x2F;&#x2F;pages.cs.wisc.edu&#x2F;~remzi&#x2F;Naur.pdf</a>
kkokosaover 2 years ago
Hi, how can I contant you? Or maybe you can reach me out on Twitter - <a href="https:&#x2F;&#x2F;twitter.com&#x2F;konradkokosa" rel="nofollow">https:&#x2F;&#x2F;twitter.com&#x2F;konradkokosa</a> ?
评论 #32562824 未加载
lapaz17over 2 years ago
Could you post updates on HN or to my email? Would love to read &quot;a different perspective than existing books out there&quot;..
sanguptaover 2 years ago
Hello. I would be happy to collaborate - been architecting applications for Adobe for many years now. My email is available in HN profile, or my Github profile <a href="https:&#x2F;&#x2F;github.com&#x2F;sangupta" rel="nofollow">https:&#x2F;&#x2F;github.com&#x2F;sangupta</a>
vagagover 2 years ago
Hey! This sounds really interesting and I think I can help with something. Do you have any contacts?
ChrisMarshallNYover 2 years ago
That&#x27;s like walking into a kindergarten class, and yelling &quot;Who wants ice cream?&quot;<p>You will not suffer for volunteers.<p>I&#x27;m probably not one of them. I&#x27;ve done that kind of thing, before, and I sincerely wish you luck, but my own dance card is fairly full.
评论 #32562881 未加载
mittermayrover 2 years ago
I&#x27;ve sold a book with a large publishing house a long while back and wanted to give you a bit of perspective on that front, in case you or anyone else may be curious:<p>Tech books used to pay a much higher royalty than &quot;regular books&quot;, like novels. I&#x27;d get 14% per book vs. 7% or less on a novel. That can make quite a bit difference. Of course, people will tell you to self-publish and keep next to 100% of your profit, but the gatekeeping function of publishing houses can be beneficial as well. I&#x27;ve had a few instances where I thought I had a fantastic idea, only to go through &quot;the process&quot; and see how it wouldn&#x27;t have sold much.<p>That said, and I may get some heat for that, self-publishing only makes sense (if you&#x27;re not just in it for the fun of typing and researching) — if you have a large-enough platform. I&#x27;d even argue that 95% of your success will be having a fantastic platform to launch this from, and 5% will be about the contents of the book (if you&#x27;re self-publishing).<p>Pieter Levels could launch a photo book of his favourite cat photos, and still make a 100k off of it. Most people can&#x27;t do that, because they don&#x27;t have the platform.<p>This differs quite a bit with publishing houses. If you can get in, and it tends to be easier in tech writing as those books can be priced much higher, then they&#x27;ll bring the platform, and you just bring the content. Once launched, you can build from this &quot;borrowed&quot; platform and try to work on your own audience. My unsolicited advice here would be to make as much as you possibly can (executing as quickly as possible) from that initial launch power and build a crowd around it that you can use as a firestarter for future projects.<p>Depending on which publishing house may offer a deal, this could mean being placed in most universities, being placed in large-chain book stores all around the world, or airports (for novels). Something that can rarely be done by self-publishing.<p>Again, not hating on the self-publishing route, especially when you look at the per-book numbers, where it&#x27;s 14% or less before taxes vs. close to a 100%, but if you don&#x27;t have a platform, then you&#x27;d probably need to be super ready for spending at least a full year on this to get it up to quality, and then also building a platform to launch it from. Just the title and name doesn&#x27;t cut it anymore, unless you do get really lucky.<p>Hope this doesn&#x27;t offend those who self-publish, if you&#x27;re doing this successfully, you are the true masters. Finding a publishing house is, in my opinion, actually the easier route.