How egorhowell/medium-articles works
Project type and purpose
• This is a modular “educational code” repository supporting a Medium blog and YouTube channel.
• It contains self-contained tutorials and examples (notebooks and scripts) across seven topical areas.
Main components
A. Content Modules (seven topic folders)
• Data Science Basics
• Modelling
• Neural Networks
• Optimisation
• Software Engineering
• Statistics
• Time Series
B. Infrastructure & Tooling
• Version control & hooks: .gitignore, .pre-commit-config.yaml, pyproject.toml
• Build & orchestration: Makefile
• Packaging/config examples:
– Docker (Software Engineering/docker-example)
– Dynaconf (Software Engineering/dynaconf-example)
• Testing examples: pytest-example, code-quality examples (black, flake8, mypy, pytest)
C. External Platforms
• Medium blog
• YouTube channel
Relationships & data flows
1. User/Contributor clones the Git repo
2. Pre-commit hooks and Makefile targets run linting, formatting, tests
3. Once infra checks pass, the user opens/runs notebooks or scripts in each Content Module
4. Docker and Dynaconf examples show how to containerize or configure code
5. Tutorial outputs feed back to the blog/YouTube (publication pipeline)
Architectural patterns & design principles
• Modular separation by topic (“single-responsibility” folders)
• Infrastructure-as-code (Makefile & built-in CI hooks drive automation)
• Example-first approach: each folder is a self-contained demonstration or tutorial