From d86f5ab572d0c5872e459d7e60ab780de61e4e6e Mon Sep 17 00:00:00 2001 From: amotech Date: Tue, 6 Oct 2026 21:05:13 +0000 Subject: [PATCH 1/4] v0.1 ask4help lesson --- .../01-introduction/03-asking-for-help.md | 114 +++++++++++++++++- 1 file changed, 112 insertions(+), 2 deletions(-) diff --git a/curriculum/01-introduction/03-asking-for-help.md b/curriculum/01-introduction/03-asking-for-help.md index 51b555c..45663f9 100644 --- a/curriculum/01-introduction/03-asking-for-help.md +++ b/curriculum/01-introduction/03-asking-for-help.md @@ -1,4 +1,5 @@ --- +--- id: asking-for-help title: Asking For Help sidebar_label: Asking For Help @@ -6,5 +7,114 @@ sidebar_position: 3 lesson: true isDraft: true --- -# Asking For Help -## Work in progress \ No newline at end of file + +# Asking For Help ❔ +**INTRODUCTION**: Getting stuck in your coding or even a learning is really part of the journey, and that is the number one why this lesson (ask for help) exists. + +## The Goal 🥅⚽ +In this lesson you will learn how to get help whenever you need it. And by the end of this lesson you should be familiar with getting stuck and how to seek for help. + + +## Lesson outline 📝 +* How to Get Help +* Who to Ask for Help +* Where to Ask for Help (**Under Construction...**) + +## How to Get Help ❔ +Steps to follow to get help: +* Before you ask, do some checks +* Use the question space +* format your code properly +* Know what to expect next + +### 1. Before You Ask ⤴➡ +Before you ask anything check if: +- your indentations are correct or valid +- your syntax are correct or valid +- your code is complete as you intended + +**If** any of above is False, Fix them and re-run your code. + +**Else**, if all of above is True and error still persist, proceed to the step 2(the question space) of this topic. + + +### 2. The Question space 📰❔ +Carefully study the `code` below: + +```python + +var1 = "12" +var2 = 12 + +results = var1 + var2 #this raises an error, why?—you will learn how to go about finding a soln—to the why, how, &what. + +``` +Your `code` should follow the pep8 style, as well as the `syntax` should be valid so you get an appropriate help response. + +### 3. How to Format Your Code 🔃 +- You are required to format your code (_python code_) using the markdown language in order to get the appropriate responses to your help requests. + +Steps to format your code: +- Type in three of the ` ``` ` character(three) to open it and close with another three of the ` ``` ` character. +- In between the opening and closing character sets, type `python` and enter a `space` character. You should have something like this: ` ```python ``` ` . +- Press `Enter` to go to a new line, now you are set to paste your `code` for submission—make sure the code syntax is valid, and is same as the one which raised the error; that is the `indentaion`, `spacing`, and `others` are all same. + + +### 4. What to Expect Next ➡ +Once you have submitted your help request, sit down tight and the appropriate help will be sent straight to you. + +If unfortunately the help response delays or never comes, use the next approach which is _Who To Ask_. + + +## Who to Ask for Help 🧔🏻❔ +subs: +* Ask yourself +* Ask someone with experience +* Ask a trusted community +* Ask an Ai agent + +### 1. Ask Yourself Before Anyone +You may say, why myself, i don't know?—Ofcourse you know all the answers to your own questions most of the times. **Ask yourself why, why did the error come; Ask yourself how, how did the error come; and Ask yourself what, what brought up a particular error** :(. You are not actually finding the correct solution to the cause of the error with these questions overnight (as if it was a magic :)), **but** what you are doing is you are training your thinking, which may help you think creatively gradually—to solve future problems. "Problem solving requires a creative and effective thinking"—Baldwin.J,. college success(2021). + +After you have had your answers to those three question, store them safely as we will learn how they might become useful later in this lesson. + +### 2. Ask Someone with Experience +Why ask someone with experience?—An experienced programmer, specifically python programmer, knows how to solve or debug almost every bug or error respectively. Therefore asking an experienced person means there is a higher probability you will get a solution to an/a error/bug. + +Now let see how your answers at the _ask yourself_ sub gets useful here. Compare your answers obtained at the _ask yourself_ sub to the ones you obtained from the experienced programmer and **Ask youself one more time—what did i missed?**—Keep this particular answer to yourself (treat it as important), it might help you in your future decisions when debugging other or similar errors later on. + +### 3. Ask a Trusted Community +Though there isn't a full guarantee that a community will contain only experienced programmers,—That is there would be beginners, intermediates and experts—but there are people with at least an experience if not much, these people might have already at least solved a bug which you just met, and could share with you how they handled it—which might be a fantastic approach you could learn also. + +Therefore asking verified communities like the stackoverflow, github, telegram groups, reddit, discord and others i could'nt mention—though one should proceed this with caution—is a must once you are learning the python or any other programming langauge. + +### 4. Ask an AI Agent +AI tools or agents are a smart way to debug errors faster, but the question is—Does the AI agent know the best approch to avoid future code breaks? + +This does not neccessarily mean using AI assistance for debugging errors is bad. But for best decision sake; That is if you know enough or understand how to select the best approach out of the many provided by the AI model, then you are encouraged to proceed with this approach—the advice is simple, that is use AI to recall the best solutions you already know quickly and not to decide the best solutions for you. + +This really counts in a serious project or even in the real world practices, but it is also a good thing to keep it in practice now—even if you are learning. + + +## Where to Ask for Help +Subs: +- Ask the social media +- Ask in learning centers + +### 1. Ask the Social Media +At least anyone who owns a smart device has an account registered on a social media platform—Some popularly known ones are: _WhatsApp, Facebook, Twitter, TikTok, Reddit, Discord, etc._—and on these platform so might be as well all kinds of programmers—experienced ones specifically. + +__Note__: +```text +In case it comes to pass that you are not registered on any of these platforms, just register on any of them to get started. +``` +**Don't just ASK** _"Hello everyone i need help with fixing a bug"_—without a link to code, media files, just this text or similar— this will actually lead others to either just leave a 'like' or do nothing. _What is the right way to ask the social media?_— **ASK by** including a clear title, clear content/message describing the error process and your expectations, a link to the code somewhere or a screenshot of the code, and optionally the methods you have used that never worked. + +### 2. Ask in Learning Centers + +- _work in progress_ + + +### What is Next? +Now that you know enough to seek for help anytime and anywhere. See next, _how to join the community_. + From 7e7691fe48e0cd4eb282d86f1cfb01c3169e6104 Mon Sep 17 00:00:00 2001 From: amotech Date: Wed, 7 Oct 2026 12:10:26 +0000 Subject: [PATCH 2/4] fixed front matter typo --- curriculum/01-introduction/03-asking-for-help.md | 1 + 1 file changed, 1 insertion(+) diff --git a/curriculum/01-introduction/03-asking-for-help.md b/curriculum/01-introduction/03-asking-for-help.md index 45663f9..e55e83c 100644 --- a/curriculum/01-introduction/03-asking-for-help.md +++ b/curriculum/01-introduction/03-asking-for-help.md @@ -1,4 +1,5 @@ --- +metadata --- id: asking-for-help title: Asking For Help From 14e2376a683aaf0946b85fe3372c4a75faeb3d44 Mon Sep 17 00:00:00 2001 From: amotech Date: Wed, 7 Oct 2026 16:49:17 +0000 Subject: [PATCH 3/4] fixed front matter: rm metadata --- .../01-introduction/03-asking-for-help.md | 31 ++++++++++--------- 1 file changed, 17 insertions(+), 14 deletions(-) diff --git a/curriculum/01-introduction/03-asking-for-help.md b/curriculum/01-introduction/03-asking-for-help.md index e55e83c..2c7c6fd 100644 --- a/curriculum/01-introduction/03-asking-for-help.md +++ b/curriculum/01-introduction/03-asking-for-help.md @@ -1,6 +1,4 @@ --- -metadata ---- id: asking-for-help title: Asking For Help sidebar_label: Asking For Help @@ -9,26 +7,29 @@ lesson: true isDraft: true --- -# Asking For Help ❔ +# Asking For Help **INTRODUCTION**: Getting stuck in your coding or even a learning is really part of the journey, and that is the number one why this lesson (ask for help) exists. -## The Goal 🥅⚽ +:::info[The Goal] + In this lesson you will learn how to get help whenever you need it. And by the end of this lesson you should be familiar with getting stuck and how to seek for help. +::: -## Lesson outline 📝 + +## Lesson outline * How to Get Help * Who to Ask for Help * Where to Ask for Help (**Under Construction...**) -## How to Get Help ❔ +## How to Get Help Steps to follow to get help: * Before you ask, do some checks * Use the question space * format your code properly * Know what to expect next -### 1. Before You Ask ⤴➡ +### 1. Before You Ask Before you ask anything check if: - your indentations are correct or valid - your syntax are correct or valid @@ -39,7 +40,7 @@ Before you ask anything check if: **Else**, if all of above is True and error still persist, proceed to the step 2(the question space) of this topic. -### 2. The Question space 📰❔ +### 2. The Question space Carefully study the `code` below: ```python @@ -52,7 +53,7 @@ results = var1 + var2 #this raises an error, why?—you will learn how to go abo ``` Your `code` should follow the pep8 style, as well as the `syntax` should be valid so you get an appropriate help response. -### 3. How to Format Your Code 🔃 +### 3. How to Format Your Code - You are required to format your code (_python code_) using the markdown language in order to get the appropriate responses to your help requests. Steps to format your code: @@ -61,13 +62,13 @@ Steps to format your code: - Press `Enter` to go to a new line, now you are set to paste your `code` for submission—make sure the code syntax is valid, and is same as the one which raised the error; that is the `indentaion`, `spacing`, and `others` are all same. -### 4. What to Expect Next ➡ +### 4. What to Expect Next Once you have submitted your help request, sit down tight and the appropriate help will be sent straight to you. If unfortunately the help response delays or never comes, use the next approach which is _Who To Ask_. -## Who to Ask for Help 🧔🏻❔ +## Who to Ask for Help subs: * Ask yourself * Ask someone with experience @@ -105,10 +106,12 @@ Subs: ### 1. Ask the Social Media At least anyone who owns a smart device has an account registered on a social media platform—Some popularly known ones are: _WhatsApp, Facebook, Twitter, TikTok, Reddit, Discord, etc._—and on these platform so might be as well all kinds of programmers—experienced ones specifically. -__Note__: -```text +:::tip + In case it comes to pass that you are not registered on any of these platforms, just register on any of them to get started. -``` + +::: + **Don't just ASK** _"Hello everyone i need help with fixing a bug"_—without a link to code, media files, just this text or similar— this will actually lead others to either just leave a 'like' or do nothing. _What is the right way to ask the social media?_— **ASK by** including a clear title, clear content/message describing the error process and your expectations, a link to the code somewhere or a screenshot of the code, and optionally the methods you have used that never worked. ### 2. Ask in Learning Centers From fa76eba9c586fc964a8f672221b954a3e0caf518 Mon Sep 17 00:00:00 2001 From: amotech Date: Fri, 9 Oct 2026 16:40:16 +0000 Subject: [PATCH 4/4] polished v3.0 phase1 --- .../01-introduction/03-asking-for-help.md | 89 ++++++++++++------- 1 file changed, 58 insertions(+), 31 deletions(-) diff --git a/curriculum/01-introduction/03-asking-for-help.md b/curriculum/01-introduction/03-asking-for-help.md index 2c7c6fd..e27a76c 100644 --- a/curriculum/01-introduction/03-asking-for-help.md +++ b/curriculum/01-introduction/03-asking-for-help.md @@ -8,11 +8,11 @@ isDraft: true --- # Asking For Help -**INTRODUCTION**: Getting stuck in your coding or even a learning is really part of the journey, and that is the number one why this lesson (ask for help) exists. +**INTRODUCTION**: Getting stuck in coding or even in your learning is normal, and that is the #1 why this lesson `ask for help` exists. Asking others for help is a must as the best devs do this almost everyday, but the most important case and question here is that, _how can someone ask for help effectively to get a quick and valuable response?_, you will know **how** as you go through this lesson carefully. :::info[The Goal] -In this lesson you will learn how to get help whenever you need it. And by the end of this lesson you should be familiar with getting stuck and how to seek for help. +In this lesson you will learn how to ask for help _effectively_ to be attended to as soon as possible and-not the other way round. By the end of this lesson you should be familiar with getting stuck and know how to ask for help _effectively_. ::: @@ -20,7 +20,7 @@ In this lesson you will learn how to get help whenever you need it. And by the e ## Lesson outline * How to Get Help * Who to Ask for Help -* Where to Ask for Help (**Under Construction...**) +* Where to Ask for Help ## How to Get Help Steps to follow to get help: @@ -40,85 +40,112 @@ Before you ask anything check if: **Else**, if all of above is True and error still persist, proceed to the step 2(the question space) of this topic. -### 2. The Question space -Carefully study the `code` below: +### 2. Use the Question space +Carefully study the `code` below: `code eg.1` ```python var1 = "12" var2 = 12 -results = var1 + var2 #this raises an error, why?—you will learn how to go about finding a soln—to the why, how, &what. +results = var1 + var2 #this raises an Error; why?—you will learn how to go about finding a soln—to the why, how, &what. ``` -Your `code` should follow the pep8 style, as well as the `syntax` should be valid so you get an appropriate help response. +Your python `code` should follow the pep8 style, as well as the `syntax` should be valid so you get an appropriate help response. ### 3. How to Format Your Code -- You are required to format your code (_python code_) using the markdown language in order to get the appropriate responses to your help requests. +- You are required to format your code (_python code_) using the markdown language in order to get a responses to your help requests. -Steps to format your code: -- Type in three of the ` ``` ` character(three) to open it and close with another three of the ` ``` ` character. -- In between the opening and closing character sets, type `python` and enter a `space` character. You should have something like this: ` ```python ``` ` . -- Press `Enter` to go to a new line, now you are set to paste your `code` for submission—make sure the code syntax is valid, and is same as the one which raised the error; that is the `indentaion`, `spacing`, and `others` are all same. +Steps to follow to format your code: +- Type in three `` ` `` characters to open a codespace and close it with another three `` ` `` characters. +- In between the opening and closing character sets, type `python` and type in a `space` character. You should have something like this: ` ```python ``` ` . +- Press `Enter` to create a new line, now paste your `code` starting from the new to any follow up line which might be the end line—make sure the code syntax is valid, same as the one which raised the error; that is the `indentaions`, `spacing`, and `other` are all same. +- When encountering the issue raised during runtime there was/is an error message specifying the line which is root cause of th error, for the line that was mentioned, add a comment at the end, briefly explaining the error message--`code eg.1` is a better illustration for these steps combined. ### 4. What to Expect Next Once you have submitted your help request, sit down tight and the appropriate help will be sent straight to you. -If unfortunately the help response delays or never comes, use the next approach which is _Who To Ask_. +If unfortunately the help response delays or never comes, know `Who To Ask` as a secondary option. ## Who to Ask for Help subs: * Ask yourself * Ask someone with experience -* Ask a trusted community +* Ask a learning community * Ask an Ai agent ### 1. Ask Yourself Before Anyone -You may say, why myself, i don't know?—Ofcourse you know all the answers to your own questions most of the times. **Ask yourself why, why did the error come; Ask yourself how, how did the error come; and Ask yourself what, what brought up a particular error** :(. You are not actually finding the correct solution to the cause of the error with these questions overnight (as if it was a magic :)), **but** what you are doing is you are training your thinking, which may help you think creatively gradually—to solve future problems. "Problem solving requires a creative and effective thinking"—Baldwin.J,. college success(2021). +You may say—why myself? i don't know?—Ofcourse you know the answers to your questions. Every successful person today found `asking themselves` first as a skill not just an act. **Ask yourself why—why is this error raised?** after you have found out the _WHY_; **Ask yourself what—what caused the error?** you found the _WHAT_ too; Now **Ask yourself how—how do i handle/fix this error so i meet my expectations?** :(. You are not actually finding the correct reason/cause/solution to the error with these questions overnight (as if it was magic :)), **but** you are actually self-training your thinking, to become creative enough, which you may start to think creatively gradually as you practice this often. "Problem solving requires a creative and effective thinking"—Baldwin.J,. College Success(2020). -After you have had your answers to those three question, store them safely as we will learn how they might become useful later in this lesson. +After you have had your answers to those `three questions`, write them down somewhere safe as you will learn how to use them soon. ### 2. Ask Someone with Experience -Why ask someone with experience?—An experienced programmer, specifically python programmer, knows how to solve or debug almost every bug or error respectively. Therefore asking an experienced person means there is a higher probability you will get a solution to an/a error/bug. +Why ask someone with experience?—An experienced person, specifically a programmer, knows how to solve/debug almost every error. Not that they know the exact answers, but they do know how to find them just by being `creative`. Therefore asking an experienced person means there is a higher probability you will get a solution to an/a error/bug, but is that all you needed, no, "Ask them how _why_ the error, _what_ caused the error and _how_ they handled the error". By doing these you will have the chance to compare to your _prior experience_ which may help you reshape your thinking to making it effective and creative. -Now let see how your answers at the _ask yourself_ sub gets useful here. Compare your answers obtained at the _ask yourself_ sub to the ones you obtained from the experienced programmer and **Ask youself one more time—what did i missed?**—Keep this particular answer to yourself (treat it as important), it might help you in your future decisions when debugging other or similar errors later on. +:::tip + +Get connected with experienced persons to learn enough to become dangerous! +::: -### 3. Ask a Trusted Community -Though there isn't a full guarantee that a community will contain only experienced programmers,—That is there would be beginners, intermediates and experts—but there are people with at least an experience if not much, these people might have already at least solved a bug which you just met, and could share with you how they handled it—which might be a fantastic approach you could learn also. +### 3. Ask a Learning Community +Though there isn't a full guarantee that a community will contain only experienced programmers—That is there would be beginners, intermediates and experts—but there are people with at least an experience if not much, these people might have already at least solved a bug which you just met, and could share with you how they handled it—which might be a fantastic approach you could learn also to build yourself. -Therefore asking verified communities like the stackoverflow, github, telegram groups, reddit, discord and others i could'nt mention—though one should proceed this with caution—is a must once you are learning the python or any other programming langauge. +Therefore asking verified communities like stackoverflow, github, telegram, reddit, discord and others i could'nt mention is a must so far as you are learning python/programming. ### 4. Ask an AI Agent -AI tools or agents are a smart way to debug errors faster, but the question is—Does the AI agent know the best approch to avoid future code breaks? +AI tools/agents are a smart way to debug errors faster, but the question is—Does the AI agent actually help you think effectively your own? -This does not neccessarily mean using AI assistance for debugging errors is bad. But for best decision sake; That is if you know enough or understand how to select the best approach out of the many provided by the AI model, then you are encouraged to proceed with this approach—the advice is simple, that is use AI to recall the best solutions you already know quickly and not to decide the best solutions for you. +This does not neccessarily mean using AI assistance for debugging errors is bad, but try to understand _why_ a fix worked by asking the Ai tool. Use AI tools to research deeper on ways you could debug `effectively` and `independently`. -This really counts in a serious project or even in the real world practices, but it is also a good thing to keep it in practice now—even if you are learning. +:::tip +It is also a good thing to keep this in practice now—especially when you are learning. +::: ## Where to Ask for Help Subs: - Ask the social media -- Ask in learning centers ### 1. Ask the Social Media -At least anyone who owns a smart device has an account registered on a social media platform—Some popularly known ones are: _WhatsApp, Facebook, Twitter, TikTok, Reddit, Discord, etc._—and on these platform so might be as well all kinds of programmers—experienced ones specifically. +At least anyone who owns a smart device has an account registered on a social media platform—Some popularly known ones are: _WhatsApp, Facebook, Twitter, TikTok, Reddit, Discord, etc._—and on these platform so might be as well all kinds of persons who do programming. -:::tip +:::tip[Quick Tip] In case it comes to pass that you are not registered on any of these platforms, just register on any of them to get started. ::: -**Don't just ASK** _"Hello everyone i need help with fixing a bug"_—without a link to code, media files, just this text or similar— this will actually lead others to either just leave a 'like' or do nothing. _What is the right way to ask the social media?_— **ASK by** including a clear title, clear content/message describing the error process and your expectations, a link to the code somewhere or a screenshot of the code, and optionally the methods you have used that never worked. +**Don't just ASK** _"Hello everyone i need help with fixing a bug"_—without a link to code, media files, just a text or similar case— this will actually lead others to either just leave or do nothing. _What is the right way to ask the social media?_— **Ask** by including a clear title, clear content/message describing the error process and your expectations, a link to the code somewhere or a screenshot of the code, and optionally the methods you have used that never worked. + +:::warning + +Do not share screenshots when you can actually _copy_ the code! +::: + -### 2. Ask in Learning Centers -- _work in progress_ +### Time to Practice +:::note[Assignment Activity] +Write any python code, run it, break it(If it run without error on the first time), copy the code and using _the guidelines on formatting your code_ you learnt earlier—format your code and paste it in any question space, then finally submit your code. - (Track the time-duration it took to receive your first response for the first time asking) + +Example format: +```python + +def add(a,b): + return a + b + +add(1, "two") #error msg: cannot concat string to an integer +``` +:::warning + +This assignment is very crucial to your journey of becoming very good in asking questions effectively to be attended to! +::: + +::: ### What is Next? -Now that you know enough to seek for help anytime and anywhere. See next, _how to join the community_. +Now that you know enough to seek for help anytime and anywhere. See next, how to _join the community_.