How faizan-im/starting-out-with-python works
Project type and purpose
• This is not a web service or library—it’s a static, file-based “learning guide” for Python.
• Purpose: organize Jupyter notebooks, practice questions, answer notebooks, and reference PDFs into a cohesive self-study curriculum.
File structure
• Top-level assets:
• *.ipynb files (Tutorial notebooks by topic)
• “Answers Starting Out with Python” (solutions notebooks)
• “Practice Questions” (exercise notebooks)
• “PDFs” (external/reference materials)
• Data files (data.csv, data.json, example.txt, etc.)
• There is no build or deployment pipeline—content is consumed directly by users running notebooks locally or viewing PDFs.
README for additional insights
• README simply states: “Whole-book – guide for anyone who wants to learn Python.”
• No automated scripts or CI/CD—this is purely a content repository.
Main components
a. Learning Modules
• Tutorial Notebooks (Chapter 1, Data Structures, File Handling, etc.)
• Practice Questions (1.ipynb, etc.)
• Answer Notebooks (solutions grouped under “Answers Starting Out with Python”)
• Reference PDFs (in “PDFs” directory)
b. Data Assets
• CSV/JSON/text files under the root that tutorial notebooks import or read
c. Repository Container
• The Git repo itself, containing all components
d. External References
• Tony Gaddis PDFs, cheat sheets, other external PDF resources
Architectural patterns & design principles
• Modular by topic: each chapter is its own notebook.
• Separation of concerns: tutorials vs exercises vs solutions vs reference materials.
• Data modularity: example data kept in separate files for reuse.
Technologies & file-types
• Jupyter notebooks (.ipynb) for interactive code and exposition
• PDF for static reference material
• CSV/JSON/TXT for sample datasets