diff --git a/docs/index.md b/docs/index.md index 000ea34..6c67e4c 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,17 +1,52 @@ -# Welcome to MkDocs +# 🌐 Building Your First API with Django and Django Rest Framework -For full documentation visit [mkdocs.org](https://www.mkdocs.org). +## Summary -## Commands +- **Total Duration:** 3 hours 30 minutes +- **Lecture:** 1 hour (approximately 30%) +- **Exercises:** 2 hours 30 minutes (approximately 70%) -* `mkdocs new [dir-name]` - Create a new project. -* `mkdocs serve` - Start the live-reloading docs server. -* `mkdocs build` - Build the documentation site. -* `mkdocs -h` - Print help message and exit. -## Project layout +[Presentation slides](https://docs.google.com/presentation/d/1Ajv9MYQQ011_Y4r1W4I6Y-6XP_faFF0317Zkn2XupMw/edit?usp=sharing) 📊 - mkdocs.yml # The configuration file. - docs/ - index.md # The documentation homepage. - ... # Other markdown pages, images and other files. +## Introduction and Overview + +- 🎬 Lecture: Introduction to Django and Django Rest Framework, and overview of API development. +- 💡 Purpose: Setting the stage and objectives for the tutorial. + +## Django Models + +- 🎬 Lecture : Fundamentals of Django models. +- 💻 Exercise : Hands-on creation and manipulation of models. +- 💡 Purpose: Understanding data handling in Django. + +## URL Mapping and Views + +- 🎬 Lecture : Explanation of URL configurations and Views/ViewSets in Django. +- 💻 Exercise : Students implement URL mapping and views for a sample API. +- 💡 Purpose: Practical understanding of Django's routing and controller mechanisms. + +## Serializers + +- 🎬 Lecture : The role and implementation of serializers. +- 💻 Exercise : Students practice converting data formats using serializers. +- 💡 Purpose: Grasping data format conversions essential in API communication. + +## Building an API - Part I + +- 💻 Exercise: Students start building a basic API, integrating learned concepts. +- 💡 Purpose: Applying accumulated knowledge in a practical project. + +## Lunch/Break + +- ⏳ Time for rest and informal discussions. + +## Building an API - Part II + +- 💻 Exercise: Continuation of the API project with instructor support. +- 💡 Purpose: Completing the API project, reinforcing learning through practice. + +## Q&A and Wrap-Up + +- 🎬 Lecture: Recap of the day's lessons, addressing questions. +- 💡 Purpose: Ensuring clarity and concluding the session.