Skip to content

Commit 42dcdda

Browse files
committed
chore: add course content directories
1 parent feb3a73 commit 42dcdda

7 files changed

Lines changed: 93 additions & 0 deletions

File tree

assets/README.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
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.

benches/README.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
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.

diagrams/README.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
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.

docs/SUMMARY.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
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)

examples/README.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
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/).

examples/soluciones/README.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
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.

tests/README.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
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.

0 commit comments

Comments
 (0)