Creeds of Craftsmanship

[coolaj86]

The Creeds of Software Craftsmanship

These are perhaps the most important archeological documents of the 21st century.

• Zen
  • The Unix Philosophy
  • Zen of Python (printable poster) [watch presentation]
  • Go Proverbs (printable poster) [watch presentation]
  • Zen of Zig
  • Axioms of AJ
• Rationalé
  • The Grug-Brained Developer
  • The Prettier Rationale
  • DRY, WET & AHA
  • The Agile Manifesto (the real one)
  • The 12 Factor App
  • The Laws of UX
  • The Rails Doctrine
  • other programmer rationals
  • The Pragmatic Programmer Tips
  • The Testing Trophy
    Books
  • A Philosophy of Software Design by John Ousterhout

Need to pull out some of the other creeds from here:

• https://gist.github.com/coolaj86/9256619

Resources of Significant Importance

Here's a few more than don't quite fit the one-liner summary:

Talks on Software Engineering

The Zen of Python Programming	(watch talk)	(Beyond Code)
Crockford on JavaScript: The Better Parts	(watch talk)	(Yahoo!)
Rob Pike on Software Engineering (in Go)	(watch talk)	(Google)
Dave Cheney on Software Engineering (in Go)	(watch talk)	(Google)
Simplicity is Complicated	(watch talk)	Rob Pike
Things in Go I Never Use	(watch talk)	Mat Ryer
How I Write HTTP Web Services after Eight Years	(watch talk)	Mat Ryer
Awesome Cold Showers	(article)	-

On Dependencies

• Go with Versions (watch talk)
• The Dangers of Dependencies
• In Defense of Not Invented Here (archive.org) by Joel Spolsky (StackOverflow)

On Critical Decisions

• Mature Optimization
• Toward Go 2 (In the face ambiguity, refuse the temptation to guess)

Needs Sorting...

Need to tease some stuff out of this:

• https://twitter.com/Aimee_Knight/status/1250926274459119616
• REST

Contemporary Bonuses

This one is too contemporary and specific to belong among the Creeds of Craftsmanship, but it certainly illuminates a type of problem that has come before and will come again. I'm just not sure how to tease it out into a distilled, more generic form.

• CryptoCurrency is an Abject Disaster
  • The Fundamental Problem With Blockchain Tech
  • Who Killed Bitcoin (documentary)

Just Plain Good Talks, Ideas, etc

General

• (Problem Decomposition) | A Philosophy of Software Design | John Ousterhout | Talks at Google
  https://www.youtube.com/watch?v=bmSAYlu0NcY (author of Tk/Tcl)
• (Patient Refactoring) | All the Little Things | Sandi Metz | RailsConf 2014
  https://www.youtube.com/watch?v=8bZh5LMaSmE
• (Constant Micro-Improvements) | The Effective Engineer | Edmond Lau | Talks at Google
  https://www.youtube.com/watch?v=BnIz7H5ruy0 (former Googler, startup junkie)
• (Emergent Design) | The Road to Zig 1.0 | Andrew Kelley
  https://www.youtube.com/watch?v=Gv2I7qTux7g
• (Design Patterns) | Why isn't Functional Programming the Norm? | Richard Feldman
  https://www.youtube.com/watch?v=QyJZzq0v7Z4&t=1192s

Go

See also: My List of Best Go Resources

• Rob Pike's Google I/O 2010 - Go Programming [watch]
• Tour of Go
• Effective Go
• YourBasic Go
• Go by Example
• Dave Cheney's Go Workshop [watch]

Zig

• (Emergent Design) | The Road to Zig 1.0 | Andrew Kelley
  https://www.youtube.com/watch?v=Gv2I7qTux7g
• "What's a Memory Allocator Anyway? - Benjamin Feng"
• "What's Zig got that C, Rust and Go don't have?"

Rust

• "The Book" - The Rust Programming Language (Amazon)
• Rust for Rustaceans
• The Rust Design Patterns Book
• Traits and trait objects - more than just interfaces - Rust Community Stuttgart

JavaScript

See also: My List of Best JavaScript Resources

• Crockford on JavaScript (Watch Full 9-Video Series)
• Why return await
• Node.js Best Practices
• Why class in JS is... terribad

Databases

• Scaling SQLite to 4m QPS on a Single Server

Other

• GitHub's Base62 token format
• Battling Bottlenecks "NTFS isn't that bad"

vim

• reddit's vimrc tips
• reddit on tabstop

[jsmart523]

@coolaj86 , you'd distilled the above into a draft list you read on JSJ 505. Are you going to post it?

[josuer08]

Hey guys, I think this talk should be included in here Mother of all demos

[coolaj86]

To-do Include these somewhere

Semantic Commits

• https://github.com/fteem/git-semantic-commits

StackOverflow Answers are a Coin Toss

• 50% of accepted answers are wrong: https://meta.stackoverflow.com/questions/411192/outdated-answers-unpinning-the-accepted-answer-a-b-test

Dependencies attack you

• https://research.swtch.com/npm-colors

Creator of Tcl/tk talks about Engineering

• Problem Decomposition with John Ousterhout: https://www.youtube.com/watch?v=bmSAYlu0NcY

[coolaj86]

• On "Plain Text" (a.k.a. PIKE MATCHBOX): https://www.youtube.com/watch?v=_mZBa3sqTrI
• How to Think Like a Programmer: https://www.youtube.com/watch?v=azcrPFhaY9k

[tobias-edwards]

Why not include "The Pragmatic Programmer"? Or at least it's tips poster if conciseness is preferred? I'm currently reading the 20th anniversary edition and it's great. I especially love the reasoning and research behind "Don't live with broken windows".

[coolaj86]

@jsmart523 It's finally coming together:
Axioms of AJScript: GPTScript/AiScript#28

[coolaj86]

@tobias-edwards I put "The Pragmatic Programmer Tips" in the list. Do you have a link to a more printable version? \ https://pragprog.com/titles/tpp20/the-pragmatic-programmer-20th-anniversary-edition/

When it is broke, it is the right time to fix it - Chinese Fortune Cookie

[tobias-edwards]

Ah yes, I glossed over it while viewing on mobile sorry! I'm afraid I've got the hardcover so no link

[coolaj86]

Better Apps: Delivering Universal UI Patterns as Web Components (Elix)

(a.k.a. How to break down functional software components into the most meaningful parts)

• https://www.youtube.com/watch?v=mtHf7crZZIQ
• https://component.kitchen/elix

Async-first Browser Development (Qwik)

Misko Hevery "Qwik framework overview": https://www.youtube.com/watch?v=Jf_E1_19aB4

[coolaj86]

Happy Path Performance (RavenDB):

• Oren Eini - Performance Architecture (Dotnetos Conference 2021
• https://www.youtube.com/watch?v=KIErf6b2RoI

[coolaj86]

Added The Unix Philosophy to the top: https://en.wikipedia.org/wiki/Unix_philosophy#Origin

[amerikan]

https://martinfowler.com/bliki/TwoHardThings.html
https://twitter.com/codinghorror/status/506010907021828096?lang=en

[coolaj86]

Ars Technica War Stories:

https://www.youtube.com/playlist?list=PLKBPwuu3eCYkScmqpD9xE7UZsszweVO0n

[coolaj86]

Algorithms to Live By - Google Tech Talk

https://www.youtube.com/watch?v=OwKj-wgXteo

How to beat the Housing / Dating / Employment market using a simple statistical economic strategy.

[coolaj86]

Preventing the Collapse of Civilization (We're Losing our Tech)

https://www.youtube.com/watch?v=ZSRHeXYDLko - Jonathan Blow at DevGAMM

This one is difficult to categorize, but there's some really important kernels in here.

[veggiemonk]

Sorry if this is not the place, just let me know and I'll delete this message.
I just saw this list of amazing talks, thanks a lot by the way. And I thought this one could be on it:
https://www.youtube.com/watch?v=8bZh5LMaSmE RailsConf 2014 - All the Little Things by Sandi Metz
It has very little to do with Ruby or Rails and more about complexity.

[rofrol]

https://grugbrain.dev/

[coolaj86]

@veggiemonk This is a great one. I disagree with her in that she doesn't consider the cost of indirection in her cost of complexity. In her admittedly trivial example, copy / paste would have been the right move... but I also can't say when inheritance would ever be a better solution that copy/paste.

That said, it' was also Kent's inspiration for "AHA" (the article was already linked). Thank you!

[coolaj86]

@rofrol I'm glad to finally know where the Grug-Brain meme comes from. This is great. Top-shelf. I've added it to the top of the Rationale section.

Other than that it's a little difficult to read (due to the meme-language it's written in), it's the perfect voice of wisdom.

[rofrol]

RAII vs DOD https://kristoff.it/blog/raii-rust-linux/