Tools

Search

Explore

Videos Channels Figures

Atmrix

About

Tools

Search

Explore

Videos Channels Figures

Atmrix

About

JO

John Ousterhout

04/09/25

@ The Pragmatic Engineer

Comments should provide information that isn't obvious from the code, especially for interfaces and member variables.

Video

TP

The Philosophy of Software Design – with John Ousterhout

@ The Pragmatic Engineer

The Philosophy of Software Design – with John Ousterhout

04/09/25

Related Takeaways

JO

John Ousterhout

04/09/25

@ The Pragmatic Engineer

AI tools can help compensate for the lack of comments in code, but they shouldn't replace the need for good documentation.

YC

Y Combinator Cast

12/08/23

@ Y Combinator

Highlighting what each line of code does in plain English helps quickly understand a foreign codebase.

JE

Jamal Eason

05/30/25

@ Google for Developers

AI features in Android Studio help developers with code commenting, making it easier to understand code when working on new projects.

MP

Michael Paulson

03/23/25

@ Lex Fridman

In Rust, you have to specify whether a variable is mutable, which makes the code more readable and understandable.

A

Anthropic Cast

06/11/25

@ Anthropic

The principles of clean software remain crucial for both human and model readability, emphasizing the importance of simplicity and avoiding unnecessary complexity in code.

ES

Emmett Shear

04/22/17

@ Y Combinator

Feedback from users of your product often reveals specific feature requests, but it's important to read between the lines to understand their true needs.

AN

Andrew Ng

05/29/25

@ LangChain

Many developers overlook the importance of creating simple evaluations, which can help identify regressions and improve system performance incrementally.

YC

Y Combinator Cast

07/06/18

@ Y Combinator

Annotations are often more effective when done by someone other than the author of a paper, as authors may not recognize where readers struggle to understand their work.

YC

Y Combinator Cast

12/08/23

@ Y Combinator

The thoughtful design of the website indicates a strong care for user experience, rather than just dumping code into a box.