Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ Detailed explanations:

The project foundation is complete. Phase 0 established the multilingual documentation, contribution workflow, collaboration templates, community standards, authorship, licensing, AI governance, automated quality checks, original visual identity, scalable repository structure, and final foundation audit.

The project foundation and seven complete educational sections are available. [Phase 7: Errors, Files, and Modules](errors-files-and-modules/README.md) is complete with five reviewed chapters, and Phase 8: Standard Library is the next planned learning section. [Phase 1: Fundamentals](fundamentals/README.md) provides six reviewed beginner chapters. Phase 6 contains six reviewed learning chapters:
The project foundation and seven complete educational sections are available, and [Phase 8: Standard Library](standard-library/README.md) is now in progress with [Chapter 01: `pathlib`](standard-library/01-pathlib/README.md). [Phase 7: Errors, Files, and Modules](errors-files-and-modules/README.md) is complete with five reviewed chapters. [Phase 1: Fundamentals](fundamentals/README.md) provides six reviewed beginner chapters. Phase 6 contains six reviewed learning chapters:

- [Comments in Python](comments-and-documentation/01-comments/README.md)
- [Docstrings in Python](comments-and-documentation/02-docstrings/README.md)
Expand All @@ -85,7 +85,7 @@ The project foundation and seven complete educational sections are available. [P
- [Comments versus Logging in Python](comments-and-documentation/05-comments-vs-logging/README.md)
- [PEP 8 and Readability in Python](comments-and-documentation/06-pep8-and-readability/README.md)

Phases 1, 2, 3, 4, 5, 6, and 7 are complete. Phase 7 contains five reviewed chapters: exception handling; deliberate raising and custom exceptions; safe file handling with `open()` and `with`; [Working with TXT, CSV, and JSON](errors-files-and-modules/04-txt-csv-and-json/README.md); and [Organizing Code with Imports, Modules, and Packages](errors-files-and-modules/05-imports-modules-and-packages/README.md), which closes the phase with explicit module imports, regular package structure, the main guard, import search context, absolute and relative imports, `python -m`, and dependency design. Phase 5: Functions contains nine reviewed chapters: [Defining and Calling Functions](functions/01-defining-and-calling-functions/README.md), [Parameters and Arguments](functions/02-parameters-and-arguments/README.md), [Return Values](functions/03-return-values/README.md), [Scope](functions/04-scope/README.md), [Type Hints](functions/05-type-hints/README.md), [Default Values](functions/06-default-values/README.md), [`*args` and `**kwargs`](functions/07-args-and-kwargs/README.md), [Functions Working Together](functions/08-functions-working-together/README.md), and [Data Flow Between Functions](functions/09-data-flow-between-functions/README.md). Together they establish function definition and calling, required input flow, returned results, local and global scope, typed interfaces, safe optional inputs, intentionally flexible positional and keyword argument collection, composition through helpers and coordinators, and explicit caller-to-parameter-to-return data flow including rebinding versus mutation. Phase 4 remains complete with eight reviewed Program Flow chapters, ending with [Choosing and Combining Program Flow](program-flow/08-choosing-and-combining-program-flow/README.md). Phase 3 contains six reviewed Collections chapters, ending with [Choosing the Right Collection](collections/06-choosing-the-right-collection/README.md). Phase 2 remains complete with four reviewed chapters, ending with [Numeric Built-ins](strings-and-numbers/04-numeric-builtins/README.md). See the [roadmap](docs/roadmap.en.md) or the [full learning path](docs/learning-path.en.md) for the current curriculum status and direct chapter links.
Phases 1, 2, 3, 4, 5, 6, and 7 are complete. Phase 8 is in progress with [Working with Filesystem Paths Using `pathlib`](standard-library/01-pathlib/README.md), which introduces path objects, portable composition, path inspection, filesystem queries, directory traversal, globbing, text helpers, and the boundary between state checks and operation failures. Phase 7 contains five reviewed chapters: exception handling; deliberate raising and custom exceptions; safe file handling with `open()` and `with`; [Working with TXT, CSV, and JSON](errors-files-and-modules/04-txt-csv-and-json/README.md); and [Organizing Code with Imports, Modules, and Packages](errors-files-and-modules/05-imports-modules-and-packages/README.md), which closes the phase with explicit module imports, regular package structure, the main guard, import search context, absolute and relative imports, `python -m`, and dependency design. Phase 5: Functions contains nine reviewed chapters: [Defining and Calling Functions](functions/01-defining-and-calling-functions/README.md), [Parameters and Arguments](functions/02-parameters-and-arguments/README.md), [Return Values](functions/03-return-values/README.md), [Scope](functions/04-scope/README.md), [Type Hints](functions/05-type-hints/README.md), [Default Values](functions/06-default-values/README.md), [`*args` and `**kwargs`](functions/07-args-and-kwargs/README.md), [Functions Working Together](functions/08-functions-working-together/README.md), and [Data Flow Between Functions](functions/09-data-flow-between-functions/README.md). Together they establish function definition and calling, required input flow, returned results, local and global scope, typed interfaces, safe optional inputs, intentionally flexible positional and keyword argument collection, composition through helpers and coordinators, and explicit caller-to-parameter-to-return data flow including rebinding versus mutation. Phase 4 remains complete with eight reviewed Program Flow chapters, ending with [Choosing and Combining Program Flow](program-flow/08-choosing-and-combining-program-flow/README.md). Phase 3 contains six reviewed Collections chapters, ending with [Choosing the Right Collection](collections/06-choosing-the-right-collection/README.md). Phase 2 remains complete with four reviewed chapters, ending with [Numeric Built-ins](strings-and-numbers/04-numeric-builtins/README.md). See the [roadmap](docs/roadmap.en.md) or the [full learning path](docs/learning-path.en.md) for the current curriculum status and direct chapter links.

## Visual identity

Expand Down
8 changes: 6 additions & 2 deletions docs/learning-path.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -99,9 +99,13 @@ This phase is already available and is the next recommended phase after Function

Phase 7 is complete with five reviewed chapters. Chapters 01–02 establish exception handling and deliberate signaling. Chapter 03 adds safe file lifetime and text I/O. Chapter 04 adds TXT, CSV, and JSON data boundaries. Chapter 05 closes the phase with modules, regular packages, `__name__`, the main guard, import search context, absolute and relative imports, `python -m`, and dependency design.

## Phase 8 · Standard Library
## Phase 8 · Standard Library 🚧

Planned. Direct chapter links will appear here when the phase begins.
[Open the Standard Library section index](../standard-library/README.md)

1. [Working with Filesystem Paths Using `pathlib`](../standard-library/01-pathlib/README.md)

Phase 8 is in progress. Chapter 01 introduces path objects, portable path composition, filesystem inspection, directory traversal, globbing, text helpers, and safe operation boundaries. The next planned chapter is **`datetime` and Time Calculations**.

## Phase 9 · External Libraries ⏳

Expand Down
8 changes: 6 additions & 2 deletions docs/learning-path.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -99,9 +99,13 @@ Esta fase ya está disponible y es la siguiente fase recomendada después de Fun

La Fase 7 está completada con cinco capítulos revisados. Los Capítulos 01–02 establecen manejo y señalización deliberada de excepciones. El Capítulo 03 añade un tiempo de vida seguro de archivos e I/O de texto. El Capítulo 04 añade límites de datos TXT, CSV y JSON. El Capítulo 05 cierra la fase con módulos, paquetes regulares, `__name__`, main guard, contexto de búsqueda de imports, imports absolutos y relativos, `python -m` y diseño de dependencias.

## Fase 8 · Biblioteca Estándar
## Fase 8 · Biblioteca Estándar 🚧

Planificado. Los enlaces directos a los capítulos aparecerán aquí cuando comience la fase.
[Abrir el índice de la sección Biblioteca Estándar](../standard-library/README.es.md)

1. [Trabajar con Rutas del Sistema de Archivos Usando `pathlib`](../standard-library/01-pathlib/README.es.md)

La Fase 8 está en progreso. El Capítulo 01 introduce objetos de ruta, composición portable, inspección del filesystem, recorrido de directorios, globbing, helpers de texto y límites seguros de operación. El próximo capítulo planificado es **`datetime` y Cálculos de Tiempo**.

## Fase 9 · Bibliotecas Externas ⏳

Expand Down
8 changes: 6 additions & 2 deletions docs/learning-path.pt-BR.md
Original file line number Diff line number Diff line change
Expand Up @@ -99,9 +99,13 @@ Esta fase já está disponível e é a próxima fase recomendada depois de Funç

A Fase 7 está concluída com cinco capítulos revisados. Os Capítulos 01–02 estabelecem tratamento e sinalização deliberada de exceções. O Capítulo 03 acrescenta tempo de vida seguro de arquivos e I/O de texto. O Capítulo 04 adiciona fronteiras de dados TXT, CSV e JSON. O Capítulo 05 encerra a fase com módulos, pacotes regulares, `__name__`, main guard, contexto de busca de imports, imports absolutos e relativos, `python -m` e design de dependências.

## Fase 8 · Biblioteca Padrão
## Fase 8 · Biblioteca Padrão 🚧

Planejado. Os links diretos dos capítulos aparecerão aqui quando a fase começar.
[Abrir o índice da seção Biblioteca Padrão](../standard-library/README.pt-BR.md)

1. [Trabalhando com Caminhos do Sistema de Arquivos Usando `pathlib`](../standard-library/01-pathlib/README.pt-BR.md)

A Fase 8 está em andamento. O Capítulo 01 introduz objetos de caminho, composição portável, inspeção do filesystem, percurso de diretórios, globbing, helpers de texto e fronteiras seguras de operação. O próximo capítulo planejado é **`datetime` e Cálculos de Tempo**.

## Fase 9 · Bibliotecas Externas ⏳

Expand Down
4 changes: 2 additions & 2 deletions docs/localized/README.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ Explicaciones detalladas:

La base del proyecto está completada. La Fase 0 estableció la documentación multilingüe, el flujo de contribución, las plantillas de colaboración, los estándares de la comunidad, la autoría, la licencia, la gobernanza de IA, las verificaciones automáticas, la identidad visual original, la estructura escalable y la auditoría final de la base.

La base del proyecto y siete secciones educativas completas están disponibles. La [Fase 7: Errores, Archivos y Módulos](../../errors-files-and-modules/README.es.md) está completada con cinco capítulos revisados, y la Fase 8: Biblioteca Estándar es la siguiente sección de aprendizaje planificada. La [Fase 1: Fundamentos](../../fundamentals/README.es.md) ofrece seis capítulos revisados para principiantes. La Fase 6 reúne seis capítulos de aprendizaje revisados:
La base del proyecto y siete secciones educativas completas están disponibles, y la [Fase 8: Biblioteca Estándar](../../standard-library/README.es.md) está ahora en progreso con el [Capítulo 01: `pathlib`](../../standard-library/01-pathlib/README.es.md). La [Fase 7: Errores, Archivos y Módulos](../../errors-files-and-modules/README.es.md) está completada con cinco capítulos revisados. La [Fase 1: Fundamentos](../../fundamentals/README.es.md) ofrece seis capítulos revisados para principiantes. La Fase 6 reúne seis capítulos de aprendizaje revisados:

- [Comentarios en Python](../../comments-and-documentation/01-comments/README.es.md)
- [Docstrings en Python](../../comments-and-documentation/02-docstrings/README.es.md)
Expand All @@ -85,7 +85,7 @@ La base del proyecto y siete secciones educativas completas están disponibles.
- [Comentarios frente a Logging en Python](../../comments-and-documentation/05-comments-vs-logging/README.es.md)
- [PEP 8 y Legibilidad en Python](../../comments-and-documentation/06-pep8-and-readability/README.es.md)

Las Fases 1, 2, 3, 4, 5, 6 y 7 están completadas. La Fase 7 reúne cinco capítulos revisados: manejo de excepciones; lanzamiento y excepciones personalizadas; uso seguro de archivos con `open()` y `with`; [Trabajar con TXT, CSV y JSON](../../errors-files-and-modules/04-txt-csv-and-json/README.es.md); y [Organizar Código con Imports, Módulos y Paquetes](../../errors-files-and-modules/05-imports-modules-and-packages/README.es.md), que cierra la fase con imports explícitos de módulos, estructura de paquete regular, main guard, contexto de búsqueda de imports, imports absolutos y relativos, `python -m` y diseño de dependencias. La Fase 5: Funciones reúne nueve capítulos revisados: [Definir y Llamar Funciones](../../functions/01-defining-and-calling-functions/README.es.md), [Parámetros y Argumentos](../../functions/02-parameters-and-arguments/README.es.md), [Valores de Retorno](../../functions/03-return-values/README.es.md), [Alcance](../../functions/04-scope/README.es.md), [Type Hints](../../functions/05-type-hints/README.es.md), [Valores Predeterminados](../../functions/06-default-values/README.es.md), [`*args` y `**kwargs`](../../functions/07-args-and-kwargs/README.es.md), [Funciones Trabajando Juntas](../../functions/08-functions-working-together/README.es.md) y [Flujo de Datos Entre Funciones](../../functions/09-data-flow-between-functions/README.es.md). Juntos establecen definición y llamada, flujo de entrada obligatorio, resultados retornados, alcance local y global, interfaces tipadas, entradas opcionales seguras, recolección intencionalmente flexible de argumentos posicionales y por palabra clave, composición mediante funciones auxiliares y coordinadoras y flujo explícito desde el llamador hacia parámetros y retornos, incluida la reasignación frente a la mutación. La Fase 4 permanece completada con ocho capítulos revisados de Flujo del Programa, terminando con [Elegir y Combinar el Flujo del Programa](../../program-flow/08-choosing-and-combining-program-flow/README.es.md). La Fase 3 reúne seis capítulos revisados de Colecciones, terminando con [Elegir la Colección Adecuada](../../collections/06-choosing-the-right-collection/README.es.md). La Fase 2 permanece completada con cuatro capítulos revisados, terminando con [Funciones Numéricas Incorporadas](../../strings-and-numbers/04-numeric-builtins/README.es.md). Consulta el [roadmap](../roadmap.es.md) o la [ruta completa de aprendizaje](../learning-path.es.md) para seguir el estado del currículo y acceder directamente a los capítulos.
Las Fases 1, 2, 3, 4, 5, 6 y 7 están completadas. La Fase 8 está en progreso con [Trabajar con Rutas del Sistema de Archivos Usando `pathlib`](../../standard-library/01-pathlib/README.es.md), que introduce objetos de ruta, composición portable, inspección de rutas, consultas al filesystem, recorrido de directorios, globbing, helpers de texto y el límite entre comprobaciones de estado y fallos de operación. La Fase 7 reúne cinco capítulos revisados: manejo de excepciones; lanzamiento y excepciones personalizadas; uso seguro de archivos con `open()` y `with`; [Trabajar con TXT, CSV y JSON](../../errors-files-and-modules/04-txt-csv-and-json/README.es.md); y [Organizar Código con Imports, Módulos y Paquetes](../../errors-files-and-modules/05-imports-modules-and-packages/README.es.md), que cierra la fase con imports explícitos de módulos, estructura de paquete regular, main guard, contexto de búsqueda de imports, imports absolutos y relativos, `python -m` y diseño de dependencias. La Fase 5: Funciones reúne nueve capítulos revisados: [Definir y Llamar Funciones](../../functions/01-defining-and-calling-functions/README.es.md), [Parámetros y Argumentos](../../functions/02-parameters-and-arguments/README.es.md), [Valores de Retorno](../../functions/03-return-values/README.es.md), [Alcance](../../functions/04-scope/README.es.md), [Type Hints](../../functions/05-type-hints/README.es.md), [Valores Predeterminados](../../functions/06-default-values/README.es.md), [`*args` y `**kwargs`](../../functions/07-args-and-kwargs/README.es.md), [Funciones Trabajando Juntas](../../functions/08-functions-working-together/README.es.md) y [Flujo de Datos Entre Funciones](../../functions/09-data-flow-between-functions/README.es.md). Juntos establecen definición y llamada, flujo de entrada obligatorio, resultados retornados, alcance local y global, interfaces tipadas, entradas opcionales seguras, recolección intencionalmente flexible de argumentos posicionales y por palabra clave, composición mediante funciones auxiliares y coordinadoras y flujo explícito desde el llamador hacia parámetros y retornos, incluida la reasignación frente a la mutación. La Fase 4 permanece completada con ocho capítulos revisados de Flujo del Programa, terminando con [Elegir y Combinar el Flujo del Programa](../../program-flow/08-choosing-and-combining-program-flow/README.es.md). La Fase 3 reúne seis capítulos revisados de Colecciones, terminando con [Elegir la Colección Adecuada](../../collections/06-choosing-the-right-collection/README.es.md). La Fase 2 permanece completada con cuatro capítulos revisados, terminando con [Funciones Numéricas Incorporadas](../../strings-and-numbers/04-numeric-builtins/README.es.md). Consulta el [roadmap](../roadmap.es.md) o la [ruta completa de aprendizaje](../learning-path.es.md) para seguir el estado del currículo y acceder directamente a los capítulos.

## Identidad visual

Expand Down
Loading