Hacker News Reader

I looked through about 8 of these templates before feeling the need to stop. While the content is mostly solid, the design and layout make them hard to use in practice.

I really appreciate the effort behind this, but they could benefit from a design pass to make them more usable and visually coherent.

View on HN

Interesting - these have exactly the design polish I'd expect from working at FB, Twitter, DBX, etc... From what I've seen most of the people I've worked with at those companies care more about the quality of my thinking than the polish of my docs.

Paul - great work. Was thinking of doing the same. I'd love to collaborate on some sort of shared resource/repo of docs like these (github?) and contribute a few of my own.

I don't know why you're getting down voted, this is an absolutely apt comment.

A shared repo on github would be great! I was wondering....where am I going to bookmark this so I'll remember to go back to it in the future. Though, how many of the people who would benefit most from these docs don't use git?

Though I may copy the docs into a confluence template.

Yeah, love that Sam. I'm not much a github user myself but if there's some existing body of best-in-class templates I'd love to be a part of that. For me, it's all about having a quick thing bookmarked that I can just duplicate from.

Reply on news.ycombinator.com