Skip to content

Commit dba234d

Browse files
committed
Enhance course documentation by adding links to assignments, prerequisites, and certification details for improved navigation and clarity. Update context for asking help to better guide students in troubleshooting.
1 parent 27e910c commit dba234d

File tree

5 files changed

+8
-9
lines changed

5 files changed

+8
-9
lines changed

ml-zoomcamp-2025/certification.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,4 +34,4 @@ The **earliest you can receive your certificate is January 2025**, which comes a
3434

3535
To clarify expectations, only two elements are strictly **required for certification**: completing 2 out of 3 projects with deployments, and conducting peer reviews (3 reviews per project you submit).
3636

37-
However, several activities are **optional but highly recommended** for your learning success. Homework assignments provide excellent practice and help solidify concepts, even though they don't directly impact certification. Learning in public activities and active community participation, while optional, significantly enhance your learning experience and can lead to career opportunities.
37+
However, several activities are **optional but highly recommended** for your learning success. [Homework assignments](assignments-and-scoring.html) provide excellent practice and help solidify concepts, even though they don't directly impact certification. Learning in public activities and active community participation, while optional, significantly enhance your learning experience and can lead to career opportunities.

ml-zoomcamp-2025/getting-help.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,4 +18,4 @@ When you encounter problems, the way you ask for help determines the quality of
1818
<img src="{{ '/assets/images/ml-zoomcamp/ml-zoomcamp-slack.png' | relative_url }}" alt="Alt text" width="80%">
1919
</div>
2020

21-
When you do need to ask for help, provide context that enables others to assist you effectively. Include specific error messages and relevant code snippets (use ```python code blocks), mention your operating system and Python version, and share a link to your GitHub repository so helpers can understand your complete setup. For example, instead of asking "My code doesn't work," provide: "I'm getting `ModuleNotFoundError: No module named 'sklearn'` on macOS with Python 3.11 when running the linear regression notebook from Module 2. Here's my repository: [link]." This approach not only gets you better answers but also helps other students who might face similar challenges.
21+
When you do need to ask for help, provide context that enables others to assist you effectively. Include specific error messages and relevant code snippets (use ```python code blocks), mention your operating system and Python version, and share a link to your GitHub repository so helpers can understand your complete setup. For example, instead of asking "My code doesn't work," provide: "I'm getting `ModuleNotFoundError: No module named 'sklearn'` on macOS with Python 3.11 when running the linear regression notebook from Module 2. Here's my repository: [link]." This approach not only gets you better answers but also helps other students who might face similar challenges.

ml-zoomcamp-2025/getting-started.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ nav_order: 0
88

99
## 1. Access Your Learning Materials
1010

11-
Start by visiting the [ML Zoomcamp GitHub repository](https://github.com/DataTalksClub/machine-learning-zoomcamp) and **starring it** ⭐. All course materials are in this repository, with each module having its own folder (for example, `01-intro` or `03-classification`). Cohort-specific homework and deadlines are located in `cohorts/2025`.
11+
Start by visiting the [ML Zoomcamp GitHub repository](https://github.com/DataTalksClub/machine-learning-zoomcamp) and **starring it** ⭐. All course materials are in this repository, with each module having its own folder (for example, `01-intro` or `03-classification`). [Cohort-specific](https://github.com/DataTalksClub/machine-learning-zoomcamp/tree/master/cohorts) homework and deadlines are located in `cohorts/2025`.
1212

1313
<div align="center">
1414
<img src="{{ '/assets/images/ml-zoomcamp/ml-zoomcamp-github-structure.png' | relative_url }}" alt="Alt text" width="80%">
@@ -30,11 +30,11 @@ Finally, locate and bookmark the [FAQ Website](https://datatalks.club/faq/machin
3030

3131
The course has **no regular live sessions** except for occasional intro streams, supporting self-paced learning.
3232

33-
While you can progress ahead of schedule, projects have deadlines to maintain cohort synchronization.
33+
While you can progress ahead of [schedule](https://courses.datatalks.club/ml-zoomcamp-2025/), projects have deadlines to maintain cohort synchronization. Learn more about the complete learning path in our [Course Curriculum](curriculum.html) and understand [Assignments and Scoring](assignments-and-scoring.html) requirements.
3434

3535
## 3. Technical Setup
3636

37-
Before diving into the coursework, ensure you have the necessary technical foundation. You'll need basic **Python knowledge** and comfort with the **command line, Git, and Docker**. Create a **GitHub account** where you'll publish all your homework code—detailed setup instructions are covered in the Prerequisites section.
37+
Before diving into the coursework, ensure you have the necessary technical foundation. You'll need basic **Python knowledge** and comfort with the **command line, Git, and Docker**. Create a **GitHub account** where you'll publish all your homework code—detailed setup instructions are covered in our [Prerequisites](prerequisites.html) guide.
3838

3939
## 4. Join the Learning Community
4040

@@ -44,7 +44,7 @@ Connect with the vibrant ML Zoomcamp community to enhance your learning experien
4444
<img src="{{ '/assets/images/ml-zoomcamp/ml-zoomcamp-slack.png' | relative_url }}" alt="Alt text" width="80%">
4545
</div>
4646

47-
Consider also joining the **Telegram Channel** for course announcements. While optional, it's highly recommended for receiving important updates and staying connected with course developments.
47+
Consider also joining the [Telegram Channel](https://t.me/mlzoomcamp) for course announcements. While optional, it's highly recommended for receiving important updates and staying connected with course developments.
4848

4949
<div align="center">
5050
<img src="{{ '/assets/images/ml-zoomcamp/ml-zoomcamp-telegram.png' | relative_url }}" alt="Alt text" width="80%">

ml-zoomcamp-2025/index.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,4 +10,3 @@ has_children: true
1010
{: .fs-9 }
1111

1212
Welcome to the **5th edition** of the Machine Learning Zoomcamp, a completely **free, hands-on course** that attracts thousands of participants each year. This comprehensive guide will walk you through everything you need to know to get started and successfully complete the course.
13-

ml-zoomcamp-2025/success.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ Consider writing blog posts about concepts you've mastered or challenges you've
2424

2525
Active learning is crucial for this hands-on course. Code along with lectures and experiment with variations to test your understanding. For instance, when working through the car price prediction in Module 2, try different features or preprocessing techniques to see how they affect model performance.
2626

27-
Homework is published under `cohorts/2025/{module}` in the course GitHub repository, with submission forms shared in Slack. While homework doesn't count toward certification, completing assignments on time helps gauge your comprehension. After each deadline passes, the submission form closes automatically.
27+
Homework is published under `cohorts/2025/{module}` in the course GitHub repository, with submission forms shared in Slack. While homework doesn't count toward certification, completing assignments on time helps gauge your comprehension. Learn more in our [Assignments and Scoring](assignments-and-scoring.html) guide. After each deadline passes, the submission form closes automatically.
2828

2929
Publish all your code to public GitHub repositories with clear documentation and meaningful commit messages like `feat: implement logistic regression for churn prediction` rather than generic `homework submission`.
3030

@@ -40,4 +40,4 @@ Use meaningful repository names that describe the project's purpose: `telecom-ch
4040

4141
Set up your development environment early using **Anaconda** (especially for Windows) and the **UV package manager** for virtual environments. Document your setup process with specific versions and commands. Use version control for all projects from the beginning.
4242

43-
Time management becomes critical as the course progresses. Each project follows a structured timeline: **2 weeks for development** followed by **1 week for peer reviews** (you must review 3 projects for each one you submit). The earliest you can receive your certificate is **January 2025**. Start homework assignments early in the week to avoid deadline pressure.
43+
Time management becomes critical as the course progresses. Each project follows a structured timeline: **2 weeks for development** followed by **1 week for peer reviews** (you must review 3 projects for each one you submit). Learn more about project requirements in [Certification and Projects](certification.html). The earliest you can receive your certificate is **January 2025**. Start homework assignments early in the week to avoid deadline pressure.

0 commit comments

Comments
 (0)