File tree Expand file tree Collapse file tree
Expand file tree Collapse file tree Original file line number Diff line number Diff line change 1+ # Assets
2+
3+ Esta carpeta guarda fuentes editables, imagenes y recursos visuales que no
4+ pertenecen directamente a ` diagrams/ ` .
5+
6+ Las visualizaciones interactivas se agregaran solo cuando aporten valor real y
7+ cuando ` academy-web ` tenga definido el mecanismo de ingestion de contenido.
Original file line number Diff line number Diff line change 1+ # Benchmarks
2+
3+ Los benchmarks existen para confrontar teoria y medicion, no para presumir
4+ numeros. Cada benchmark debe estar conectado con una afirmacion de complejidad
5+ del capitulo correspondiente.
6+
7+ Convencion de nombres:
8+
9+ ``` text
10+ <modulo>_bench.rs
11+ ```
12+
13+ Si una medicion contradice la intuicion o la teoria, se documenta como hallazgo
14+ y se explica en el capitulo.
Original file line number Diff line number Diff line change 1+ # Diagramas
2+
3+ Los diagramas de este curso se escriben en Mermaid siempre que el tipo de
4+ diagrama lo permita (RFC-0001 §12). Cada archivo debe poder entenderse sin leer
5+ el capitulo completo: titulo claro, etiquetas completas y leyenda cuando haga
6+ falta.
7+
8+ Convencion de nombres:
9+
10+ ``` text
11+ NN-nombre-del-capitulo.mmd
12+ ```
13+
14+ Los SVG solo se usan cuando Mermaid no pueda expresar el diagrama con claridad.
15+ En ese caso, el archivo fuente editable vive junto al SVG.
Original file line number Diff line number Diff line change 1+ # Summary
2+
3+ - [ Vector] ( ./01-vector.md )
4+ - [ Linked List] ( ./02-linked-list.md )
5+ - [ Stack] ( ./03-stack.md )
6+ - [ Queue] ( ./04-queue.md )
7+ - [ Deque] ( ./05-deque.md )
8+ - [ Heap] ( ./06-heap.md )
9+ - [ Trie] ( ./07-trie.md )
10+ - [ Graph] ( ./08-graph.md )
11+ - [ B-Tree] ( ./09-btree.md )
12+ - [ HashMap] ( ./10-hashmap.md )
13+ - [ Bloom Filter] ( ./11-bloom-filter.md )
14+ - [ Skip List] ( ./12-skip-list.md )
Original file line number Diff line number Diff line change 1+ # Ejemplos
2+
3+ Los ejemplos muestran cada estructura en cuatro niveles:
4+
5+ 1 . Basico: uso minimo de la API.
6+ 2 . Intermedio: combinacion de operaciones.
7+ 3 . Avanzado: caso limite, medicion o variante.
8+ 4 . Caso real: situacion cercana a un sistema de produccion.
9+
10+ Convencion de nombres:
11+
12+ ``` text
13+ <modulo>_basic.rs
14+ <modulo>_intermediate.rs
15+ <modulo>_advanced.rs
16+ <modulo>_real_case.rs
17+ ```
18+
19+ Las soluciones de ejercicios de niveles 1 a 3 viven en
20+ [ ` soluciones/ ` ] ( ./soluciones/ ) .
Original file line number Diff line number Diff line change 1+ # Soluciones
2+
3+ Aqui viven las soluciones de ejercicios de niveles 1 a 3 (RFC-0001 §17).
4+
5+ Cada solucion debe tener el mismo estandar que el codigo principal: nombres
6+ claros, pruebas cuando aplique, explicacion de complejidad y ninguna solucion
7+ "rapida" que enseñe malos habitos.
8+
9+ Los desafios de nivel 4 no tienen una unica solucion. Para ellos se publica una
10+ discusion de enfoques y tradeoffs dentro del capitulo.
Original file line number Diff line number Diff line change 1+ # Tests De Integracion
2+
3+ Los tests de integracion validan el comportamiento publico de cada estructura.
4+ Los detalles internos se cubren con tests unitarios dentro de ` src/ ` .
5+
6+ Convencion de nombres:
7+
8+ ``` text
9+ <modulo>_test.rs
10+ ```
11+
12+ Cada test debe corresponder a un caso descrito en el capitulo: si la teoria
13+ identifica un borde, el repo debe tener una prueba para ese borde.
You can’t perform that action at this time.
0 commit comments