-
Notifications
You must be signed in to change notification settings - Fork 3
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Update index page in the documentation
Replaced the previous content of the index page in the documentation with an in-depth guide on building an API using Django and Django Rest Framework, which includes estimated durations, lectures, exercises and a link to presentation slides. The new content presents a structured and comprehensive learning journey for the readers.
- Loading branch information
1 parent
367655a
commit e1e3daf
Showing
1 changed file
with
47 additions
and
12 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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. |