Skip to content

IndrajeetPatil/second-hardest-cs-thing

Repository files navigation

Dealing with the Second Hardest Thing in Computer Science

This presentation summarizes my understanding of best practices in naming things for software development.

The title is inspired by the following quote:

"There are only two hard things in Computer Science: cache invalidation and naming things."
- Phil Karlton

The slides can be seen here:
https://www.indrapatil.com/second-hardest-cs-thing/

introductory slide

Development

This project uses Python 3.14 (see .python-version) with uv for dependency management, Quarto for rendering slides, and just as a command runner.

Prerequisites

# Install just (macOS)
brew install just

Setup

just install

Just Commands

just help     # Show all available commands
just install  # Install Quarto extensions and Python dependencies
just update   # Update Quarto extensions and Python dependencies
just render   # Render slides to HTML
just preview  # Start a live preview with auto-reload
just open     # Open rendered slides in the default browser
just clean    # Remove generated files and caches
just check    # Check the Quarto and Python setup
just          # Install dependencies, render, and open slides

Feedback

Feedback and suggestions are welcome in the issue tracker.

Packages

 
 
 

Contributors