https://github.com/indrajeetpatil/second-hardest-cs-thing
Transforming code clarity through better names
https://github.com/indrajeetpatil/second-hardest-cs-thing
computer-science naming-conventions quartopub reveal-js software-development software-engineering
Last synced: 3 months ago
JSON representation
Transforming code clarity through better names
- Host: GitHub
- URL: https://github.com/indrajeetpatil/second-hardest-cs-thing
- Owner: IndrajeetPatil
- License: cc0-1.0
- Created: 2022-03-27T07:58:16.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-10-05T00:13:56.000Z (8 months ago)
- Last Synced: 2025-10-05T02:36:09.552Z (8 months ago)
- Topics: computer-science, naming-conventions, quartopub, reveal-js, software-development, software-engineering
- Language: HTML
- Homepage: https://indrajeetpatil.github.io/second-hardest-cs-thing/
- Size: 94.7 MB
- Stars: 33
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# 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:
# Development
This project uses Python 3.13+ with [uv](https://docs.astral.sh/uv/) for dependency management, [Quarto](https://quarto.org/) for rendering slides, and [just](https://github.com/casey/just) as a command runner.
## Prerequisites
```bash
# Install just (macOS)
brew install just
```
## Setup
```bash
# Install dependencies
just install
# Or update to latest versions
just update
```
## Common Commands
```bash
just help # Show all available commands
just render # Render slides to HTML
just preview # Live preview with auto-reload
just open # Open rendered slides in browser
just clean # Remove generated files
just check # Check Quarto and Python setup
just # Install, render, and open slides (default)
```
# Feedback
I'd love to hear thoughts and comments [here](https://github.com/IndrajeetPatil/second-hardest-cs-thing/issues).
# Code of Conduct
Please note that the second-hardest-cs-thing project is released with a [Contributor Code of Conduct](https://www.contributor-covenant.org/version/3/0/code_of_conduct/). By contributing to this project, you agree to abide by its terms.