Engineering Book Notes

Software engineering book notes in Spanish and English, curated to help developers quickly find meaningful reflections and practical takeaways.

Language portal

Choose how you want to read this repository:

• English: README.md
• Español: README.es.md

Cover

Interactive navigation

• What's new
• Why this repository exists
• Start here
• Books index
• Discovery quick start
• Presentations
• How to navigate
• How to use this repository
• Repository structure
• License
• Disclaimer

Recommended flow (expand/collapse)

1. Enter a book from the Books index.
2. Open its README to view the chapter table of contents.
3. In each chapter use ← Back to Book, ↑ Back to Index, and 🌐 Switch Language.
4. Use Related notes and See also to jump between concepts.

What's new

This section shows only the latest 3 updates in the repository. It must be refreshed whenever content is added or updated in any book.

• New slides: The Pragmatic Programmer (ch. 0, 1, 2, 4)
• Status updated: The Pragmatic Programmer is now completed
• Concepts index updated with postface: Concepts index

Why this repository exists

This repository exists to turn reading notes into a practical engineering handbook:

• Capture personal reflections, lessons, and actionable ideas.
• Keep concepts easy to find by book, chapter, and topic.
• Share notes publicly with a professional English translation.
• Build a long-term reference that remains useful over time.

Language policy

• Spanish is the source of truth.
• English is a clean and professional translation.
• Each file uses only one language.

Start here

• If you want a fast read: open a book README and use quick navigation.
• If you want concept depth: open a chapter and follow Related notes + See also.
• If you want to add notes: use templates in templates/ and write Spanish first.

Discovery quick start

• Concepts index: docs/concepts-index.md | ES
• Reading paths: docs/reading-paths.md | ES

Presentations

• The Pragmatic Programmer (0, 1, 2, 4): Open slides
• Slide editing guide: README.md | ES

Books index

Book	Status	Chapters	English	Spanish
software-engineering-at-google	reading	5	Open	Abrir
the-pragmatic-programmer	completed	10	Open	Abrir

Global quick map (expand/collapse)

Book	Chapter	EN	ES
Software Engineering at Google	01 - What is software engineering?	Open	Abrir
Software Engineering at Google	02 - Working well in teams	Open	Abrir
Software Engineering at Google	03 - Sharing knowledge	Open	Abrir
Software Engineering at Google	05 - Team leadership	Open	Abrir
Software Engineering at Google	09 - Code review	Open	Abrir
The Pragmatic Programmer	00 - Preface	Open	Abrir
The Pragmatic Programmer	01 - A pragmatic philosophy	Open	Abrir
The Pragmatic Programmer	02 - A pragmatic approach	Open	Abrir
The Pragmatic Programmer	04 - Pragmatic paranoia	Open	Abrir
The Pragmatic Programmer	05 - Bend, or break	Open	Abrir
The Pragmatic Programmer	06 - Concurrency	Open	Abrir
The Pragmatic Programmer	07 - While you are coding	Open	Abrir
The Pragmatic Programmer	08 - Before the project	Open	Abrir
The Pragmatic Programmer	09 - Pragmatic projects	Open	Abrir
The Pragmatic Programmer	10 - Postface	Open	Abrir

How notes are organized

Notes are organized in three levels:

1. Repository index (README.md, README.es.md)
2. Book index (books/<book-name>/README*.md)
3. Chapter notes (books/<book-name>/chapters/ES/*.es.md and books/<book-name>/chapters/EN/*.md)

Each chapter includes top and bottom navigation, language switching, and cross-links.

Repository structure

.
├── LICENSE
├── README.es.md
├── README.md
├── books/
│   ├── software-engineering-at-google/
│   │   ├── README.es.md
│   │   ├── README.md
│   │   └── chapters/
│   │       ├── EN/
│   │       │   ├── 01-introduction.md
│   │       │   ├── 02-working-well-in-teams.md
│   │       │   ├── 03-sharing-knowledge.md
│   │       │   ├── 05-team-leadership.md
│   │       │   └── 09-code-review.md
│   │       └── ES/
│   │           ├── 01-introduction.es.md
│   │           ├── 02-como-trabajar-bien-en-equipo.es.md
│   │           ├── 03-compartir-conocimientos.es.md
│   │           ├── 05-team-leadership.es.md
│   │           └── 09-revision-de-codigo.es.md
│   └── the-pragmatic-programmer/
│       ├── README.es.md
│       ├── README.md
│       └── chapters/
│           ├── EN/
│           │   ├── 00-preface.md
│           │   ├── 01-a-pragmatic-philosophy.md
│           │   ├── 02-a-pragmatic-approach.md
│           │   ├── 04-pragmatic-paranoia.md
│           │   ├── 05-bend-or-break.md
│           │   ├── 06-concurrency.md
│           │   ├── 07-while-you-are-coding.md
│           │   ├── 08-before-the-project.md
│           │   ├── 09-pragmatic-projects.md
│           │   └── 10-postface.md
│           └── ES/
│               ├── 00-prefacio.es.md
│               ├── 01-una-filosofia-pragmatica.es.md
│               ├── 02-un-enfoque-pragmatico.es.md
│               ├── 04-paranoia-pragmatica.es.md
│               ├── 05-doblar-o-romper.es.md
│               ├── 06-concurrencia.es.md
│               ├── 07-mientras-escribe-codigo.es.md
│               ├── 08-antes-del-proyecto.es.md
│               ├── 09-proyectos-pragmaticos.es.md
│               └── 10-postfacio.es.md
├── docs/
│   ├── concepts-index.es.md
│   ├── concepts-index.md
│   ├── reading-paths.es.md
│   └── reading-paths.md
├── slides/
│   └── pragmatic-programmer/
│       ├── index.html
│       ├── README.es.md
│       ├── README.md
│       └── assets/
│           ├── app.js
│           ├── slides.js
│           └── styles.css
└── templates/
    ├── book-template.es.md
    ├── book-template.md
    ├── chapter-template.es.md
    └── chapter-template.md

How to navigate

Use this route for quick navigation:

1. Start from the books index in this file.
2. Open a book README to see the chapter table of contents.
3. Open a chapter and use:
   • ← Back to Book
   • ↑ Back to Index
   • 🌐 Switch Language
4. Move between chapters from the bottom navigation:
   • Previous chapter
   • Next chapter
   • Related notes

How to use this repository

• Use templates in templates/ to add books and chapters.
• Update Spanish files first and then translate into English.
• Add short quotes and practical actions.
• Keep cross-links between related concepts.

Short content creation flow

1. Create the book folder under books/<book-name>/.
2. Create README.es.md and README.md using templates/book-template.*.
3. Create chapters in chapters/ES/ and translate to chapters/EN/ using templates/chapter-template.*.
4. Update books index and chapter navigation links.

License

This project is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).

Scope note: this license applies only to original content created in this repository (notes, structure, and personal interpretations).

See LICENSE.

Disclaimer

• These notes are personal interpretations and learning material.
• Any quoted content belongs to its original authors and publishers.
• Quotes are short, attributed when possible, and included for educational purposes.
• This repository does not republish full chapters or substantial copyrighted excerpts.