Update vi mi first steps (#3557)

xyb994 · web-flow · commit 7b14c1ee160a · 2025-01-20T18:04:19.000-05:00
diff --git a/navigation.md b/navigation.md
@@ -24,8 +24,8 @@
   * [**Introduction / First Steps**](pages/vi/vi-first-steps.md)
   * [FAQ](pages/vi/vi-faq.md)
   - - - -
-  * [Step 0 - Introductory Steps](pages/vi/vi-first-steps.md#Step_0_-_Introductory_Steps)
-  * [Step 1 - Markdown and Fork Tutorial](pages/vi/vi-github-and-markdown.md)
+  * [Step 0 - Introductory Step](pages/vi/vi-intro-step.md)
+  * [Step 1 - GitHub, Markdown, and Forking Workflow](pages/vi/vi-github-and-markdown.md)
   * [Step 2 - Software Prerequisites](pages/vi/vi-prerequisites.md)
   * [Step 3 - Planet and Docker](pages/vi/vi-first-steps.md#Step_3_-_Planet_and_Docker)
   * [&nbsp; &nbsp; Docker Tutorial](pages/vi/vi-docker-tutorial.md)
@@ -48,14 +48,14 @@
   * [**Introduction / First Steps**](pages/mi/mi-10-steps.md)
   * [FAQ](pages/mi/mi-faq.md)
   - - - -
-  * [Step 0 - Prerequisites](pages/mi/mi-10-steps.md#Step_0_-_Prerequisites)
-  * [Step 1 - Markdown & Forking Workflow](pages/mi/mi-10-steps.md#Step_1_-_Markdown_&_Forking_Workflow)
-  * [Step 2 - myPlanet App](pages/mi/mi-10-steps.md#Step_2_-myPlanet_App)
-  * [Step 3 - Build myPlanet in Android Studio](pages/mi/mi-10-steps.md#Step_3_-_Build_myPlanet_in_Android_Studio)
-  * [Step 4 - Connect myPlanet to Planet](pages/mi/mi-10-steps.md#Step_4_-_Connect_myPlanet_app_to_Planet)
+  * [Step 0 - Introductory Step](pages/mi/mi-intro-step.md)
+  * [Step 1 - Markdown & Forking Workflow](pages/mi/mi-github-and-markdown.md)
+  * [Step 2 - myPlanet App](pages/mi/mi-myplanet.md)
+  * [Step 3 - myPlanet and Android Studio](pages/mi/mi-myplanet-and-android-studio.md)
+  * [Step 4 - Connect myPlanet app to Planet](pages/mi/mi-myplanet-connection.md)
   * [Step 5 - Git Repositories](pages/mi/mi-github-and-repositories.md)
   * [Step 6 - GitHub Issues Tutorial](pages/mi/mi-10-steps.md#Step_6_-_GitHub_Issues_Tutorial)
-  * [Step 7 - Take a Course on myPlanet, Courses Gardening](pages/mi/mi-10-steps.md#Step_7_-_Take_a_Course_on_myPlanet,_Courses_Gardening)
+  * [Step 7 - Take a Course on myPlanet, Courses Gardening](pages/mi/mi-myplanet-course.md)
   * [Step 8 - Create More Issues and Pull Requests](pages/mi/mi-issues-and-prs.md)
   * [Step 9 - Kotlin Tour](pages/mi/mi-10-steps.md#Step_9_-_Kotlin_Tour)
   * [Step 10 - Be Part of the Team](pages/mi/mi-10-steps.md#Step_10_-_Be_part_of_the_team)
diff --git a/pages/mi/mi-10-steps.md b/pages/mi/mi-10-steps.md
@@ -37,17 +37,9 @@ If you have general internship inquiries and can't find the information you need
 
 For technical questions not covered in the FAQ, in addition to contacting us on Discord, Google and Stack Exchange serve as excellent supplementary resources to explore. :)
 
-## Step 0 - Prerequisites
+## Step 0 - Introductory Step
 
-To participate in the internship, you will need the following:
-
-1. A laptop or desktop computer with at least 8GB of RAM.
-2. An Android device (phone or tablet) with a minimum of 3GB of RAM and running Android 9 "Pie" or later, and/or a Chromebook.
-   - If you do not have a physical Android or Chromebook device, you can use a [Raspberry Pi 4](https://emteria.com/kb/hardware#raspberry-pi-4b) [or 5](https://emteria.com/kb/hardware#raspberry-pi-5) with at least 8GB of RAM as an experimental alternative.
-3. [Discord](https://discord.com/download) installed on both your Android device and your laptop or desktop computer for easier communication and screenshot sharing.
-4. A stable internet connection.
-
-**Once you have confirmed that you meet the aforementioned requirements, please say hi to everyone in the Discord channel and let us know that you have reached Step 0.**
+Follow the instructions on [Mobile Interns Introductory Step](mi-intro-step.md).
 
 ## Step 1 - Markdown & Forking Workflow
 
@@ -57,15 +49,15 @@ Follow the instructions on [Creating Your GitHub Profile Page: A Guide to Markdo
 
 ## Step 2 - myPlanet App
 
-Please follow the directions at [myPlanet App](step2.md) to download and test the beta version of myPlanet.
+Please follow the directions at [myPlanet App](mi-myplanet.md) to download and test the beta version of myPlanet.
 
 ## Step 3 - Build myPlanet in Android Studio
 
 Follow the guide at [myPlanet and Android Studio](mi-myplanet-and-android-studio.md) to clone myPlanet repository from GitHub and build the myPlanet app with Android Studio.
 
 ## Step 4 - Connect myPlanet app to Planet
 
-Follow the guide at [Connecting myPlanet to Planet](mi-step4.md).
+Follow the guide at [Connecting myPlanet to Planet](mi-myplanet-connection.md).
 
 ## Step 5 - Git Repositories: A Guide to Cloning, Configuring, and Syncing Forks
 
diff --git a/pages/mi/mi-intro-step.md b/pages/mi/mi-intro-step.md
@@ -0,0 +1,39 @@
+# Step 0 - Mobile Interns Introductory Step
+
+## Internship Hardware Requirements
+
+To participate in this internship, you will need the following:
+
+1. A laptop or desktop computer with a minimum of 8GB of RAM.
+2. An Android device (phone or tablet) with a minimum of 3GB of RAM and running Android 9 "Pie" or later, and/or a Chromebook.
+   - If you do not have a physical Android or Chromebook device, we suggest asking around to see if a friend or family member has an old Android phone they no longer use.
+3. A stable internet connection.
+
+**Once you have confirmed that you meet the aforementioned requirements, please say hi to everyone in the Discord channel and let us know that you have reached Step 0.**
+
+## Watch the Organization and Follow Contributors
+
+In GitHub, we [follow organizations](https://docs.github.com/en/get-started/exploring-projects-on-github/following-organizations) and [follow people](https://docs.github.com/en/get-started/exploring-projects-on-github/following-people) to receive notifications about their activity. Look for the "Watch" button at the top right of the page when you are in a repository. Additionally, follow each other to stay updated on what others in the group are working on.
+
+- Use the "Watch" button in repositories you're working on and "Follow" individuals to keep up with the latest activities.
+- Follow the [Open Learning Exchange
+](https://github.com/open-learning-exchange) to stay updated on changes with OLE on GitHub.
+- Watch the [Open Learning Exchange's myPlanet repository](https://github.com/open-learning-exchange/myplanet) to stay updated on changes with the main repository you'll be working on.
+- Follow OLE's CTO [dogi](https://github.com/dogi) and myPlanet's core developer [Gideon](https://github.com/Okuro3499) on GitHub.
+- You can also follow [other active mobile interns](mi-team.md) to stay updated on their activities.
+
+## Package Management (macOS/Windows)
+
+If you are on macOS or Windows, we recommend you get a package manager:
+
+- macOS: [Homebrew](https://brew.sh/) or [MacPorts](https://www.macports.org/)
+- Windows: [Chocolatey Community](https://community.chocolatey.org/)
+
+## Discord Installation and Server Nickname
+
+- Discord will be the primary communication tool for this internship, so please [download and install it](https://discord.com/download) on your computer and Android device.
+   - with Homebrew `brew install --cask discord`
+   - with Chocolatey `choco install discord`
+- If your preferred name differs significantly from your Discord "Display Name," click on "treehouses" in the upper left of the Discord interface. Then, select "Edit Server Profile" from the menu and update your server nickname to include your preferred name or first name and last name initial.
+
+#### Return to [First Steps](mi-10-steps.md#Step_0_-_Introductory_Step)
diff --git a/pages/mi/mi-issues-and-prs.md b/pages/mi/mi-issues-and-prs.md
@@ -1,5 +1,17 @@
 # Step 8 - Create More Issues and Pull Requests
 
+## Objectives
+
+- Create three more issues
+- Add comments to three other issues
+- Resolving three issues
+
+## Introduction
+
+Just as your learning with this Wiki was made possible by the efforts of previous interns, now we turn to you to continue that tradition and help future mobile interns take their First Steps. Through this step, you should try to further improve our Markdown Wiki, with better explanations, formatting fixes, and more! You must have made your pull requests and have them each approved by at least two other OLE team members/interns in order for it to be merged to the upstream repository. Just as before, announce your Pull Request on the Discord channel so other members can review it. You may need to make some additional corrections. Learn by teaching - or editing our teaching tool, in this case!
+
+## ToDo
+
 In this step, your goal is to create, comment on, and resolve GitHub issues to improve our Markdown Wiki. Here's what you'll need to do:
 
 1. **Create Issues**:
@@ -28,6 +40,13 @@ Once you complete Step 8 you will have:
 - 4 comments made on issues you didn't create (one at step 6 and three at step 8)
 - 4 issues created (one at step 6 and three at step 8)
 
-**HINT**: You can track your progress with the number of pull requests and issues [here](../track-first-steps-progress.md).
+## Track Your Progress
+
+- After completing Step 8, you should have:
+  - 5 merged pull requests (one from Step 1, one from Step 6, and three from Step 8)
+  - 4 comments on *issues you didn't create* (one from Step 6 and three from Step 8)
+  - 4 issues created (one from Step 6 and three from Step 8)
+
+Hint: You can track your progress with the number of pull requests and issues [**here**](../track-first-steps-progress.md).
 
 #### Return to [First Steps](mi-10-steps.md#Step_8_-_Create_More_Issues_and_Pull_Requests)
diff --git a/pages/mi/mi-myplanet-connection.md b/pages/mi/mi-myplanet-connection.md
@@ -1,4 +1,4 @@
-# Connecting myPlanet to Planet
+# Step 4 - Connecting myPlanet to Planet
 
 ## Background
 
diff --git a/pages/mi/mi-myplanet-course.md b/pages/mi/mi-myplanet-course.md
@@ -1,4 +1,4 @@
-# Take a Course on myPlanet, Courses Gardening
+# Step 7 - Take a Course on myPlanet, Courses Gardening
 
 ## myPlanet App Dashboard and Courses Overview
 
diff --git a/pages/mi/mi-myplanet.md b/pages/mi/mi-myplanet.md
diff --git a/pages/vi/vi-create-issues-and-pull-requests.md b/pages/vi/vi-create-issues-and-pull-requests.md
@@ -1,4 +1,4 @@
-# Create More Issues and Pull Requests (Step 8)
+# Step 8 - Create More Issues and Pull Requests
 **Estimated Time: 4.5h**
 
 ## Objectives
diff --git a/pages/vi/vi-docker-development-tutorial.md b/pages/vi/vi-docker-development-tutorial.md
@@ -1,4 +1,4 @@
-﻿# Planet Development Setup Tutorial (Step 9)
+﻿# Step 9 - Planet Development Setup Tutorial
 **Estimated Time: 3h** 
 
 ## Objectives
diff --git a/pages/vi/vi-docker-tutorial.md b/pages/vi/vi-docker-tutorial.md
@@ -1,4 +1,4 @@
-﻿# Docker Tutorial (Step 3.1)
+﻿# Step 3.1 - Docker Tutorial
 **Estimated Time: 1h** 
 
 ## Objectives
diff --git a/pages/vi/vi-first-steps.md b/pages/vi/vi-first-steps.md
@@ -37,25 +37,12 @@ For technical questions not covered in the FAQ, in addition to contacting us on
 ## Step 0 - Introductory Steps
 **(Estimated Time: 1h)**
 
-This step includes two tasks:
-
-1. **Watch the Repository and Follow Contributors:**
-   - To keep up with the latest activities, use the "Watch" button in repositories and "Follow" individuals.
-   - Visit [GitHub](https://github.com), and watch the [Open Learning Exchange's Planet repository](https://github.com/open-learning-exchange/planet) to stay updated on changes.
-   - Follow OLE's CTO [dogi](https://github.com/dogi) and Planet's core developer [Mutugi](https://github.com/Mutugiii) on GitHub.
-  - You can also follow [other active virtual interns](vi-team.md) to stay updated on their activities.
-
-   ![Watch Screen Shot](images/vi-watch.png)
-   ![Follow Screen Shot](images/vi-follow.png)
-
-2. **Contribute to Translations on Crowdin:**
-   - We use Crowdin to translate our user interface into multiple languages.
-   - If you know [a language supported by Planet](https://crowdin.com/project/ole-planet), your translation assistance would be greatly appreciated. Create a Crowdin account and aim to translate at least 10% of the words in your chosen language. For an overview of the functionality and terminology, refer to the [Planet User Manual](#!./pages/techgenius/tg-planet-user-manual.md). Your contributions will help both the project and enhance your understanding of Planet. Be sure to let us know in the [#vi-software channel](https://discord.com/channels/1079980988421132369/1229437557843169280) on Discord if you're able to contribute to our translation efforts.
+Follow the instructions on [Software Interns Introductory Step](vi-intro-step.md).
 
-## Step 1 - Markdown and Fork Tutorial
+## Step 1 - GitHub, Markdown, and Forking Workflow
 **(Estimated Time: 1.5h)**
 
-Follow the instructions on the [GitHub and Markdown page](vi-github-and-markdown.md).
+Follow the instructions on the [GitHub, Markdown, and Forking Workflow page](vi-github-and-markdown.md).
 
 - Once you complete this step, you will have:
   - 1 Pull request made
diff --git a/pages/vi/vi-github-and-markdown.md b/pages/vi/vi-github-and-markdown.md
@@ -1,5 +1,5 @@
-# GitHub and Markdown (Step 1)
-**Estimated Time: 1.5h** 
+# Step 1 - GitHub, Markdown, and Forking Workflow
+**Estimated Time: 1.5h**
 
 ## 1. Objectives
 
@@ -143,4 +143,4 @@ After the pull request is merged, you'll be able to see your personal page at `o
 
 **→** Next: [Step 2 - Software Prerequisites](vi-prerequisites.md)
 
-Return to [First Steps](vi-first-steps.md#Step_1_-_Markdown_and_Fork_Tutorial)
+Return to [First Steps](vi-first-steps.md#Step_1_-_GitHub,_Markdown,_and_Forking_Workflow)
diff --git a/pages/vi/vi-github-and-repositories.md b/pages/vi/vi-github-and-repositories.md
@@ -1,4 +1,4 @@
-# Git Repositories (Step 5)
+# Step 5 - Keeping Fork Updated
 **Estimated Time: 1h** 
 
 ## Objectives
diff --git a/pages/vi/vi-github-issues.md b/pages/vi/vi-github-issues.md
@@ -1,4 +1,4 @@
-# GitHub Issues (Step 6)
+# Step 6 - GitHub Issues
 **Estimated Time: 2.5h** 
 
 ## 1. Objectives
diff --git a/pages/vi/vi-intro-step.md b/pages/vi/vi-intro-step.md
@@ -0,0 +1,42 @@
+# Step 0 - Software Interns Introductory Step
+
+## Internship Hardware Requirements
+
+To participate in this internship, you will need the following:
+
+1. A laptop or desktop computer with a minimum of 8GB of RAM.
+2. A stable internet connection.
+
+**Once you have confirmed that you meet the aforementioned requirements, please say hi to everyone in the Discord channel and let us know that you have reached Step 0.**
+
+## Watch the Organization and Follow Contributors
+
+In GitHub, we [follow organizations](https://docs.github.com/en/get-started/exploring-projects-on-github/following-organizations) and [follow people](https://docs.github.com/en/get-started/exploring-projects-on-github/following-people) to receive notifications about their activity. Look for the "Watch" button at the top right of the page when you are in a repository. Additionally, follow each other to stay updated on what others in the group are working on.
+
+- Use the "Watch" button in repositories you're working on and "Follow" individuals to keep up with the latest activities.
+- Follow the [Open Learning Exchange
+](https://github.com/open-learning-exchange) to stay updated on changes with OLE on GitHub.
+- Watch the [Open Learning Exchange's Planet repository](https://github.com/open-learning-exchange/planet) to stay updated on changes with the main repository you'll be working on.
+- Follow OLE's CTO [dogi](https://github.com/dogi) and Planet's core developer [Mutugi](https://github.com/Mutugiii) on GitHub.
+- You can also follow [other active mobile interns](vi-team.md) to stay updated on their activities.
+
+## Package Management (macOS/Windows)
+
+If you are on macOS or Windows, we recommend you get a package manager:
+
+- macOS: [Homebrew](https://brew.sh/) or [MacPorts](https://www.macports.org/)
+- Windows: [Chocolatey Community](https://community.chocolatey.org/)
+
+## Discord Installation and Server Nickname
+
+- Discord will be the primary communication tool for this internship, so please [download and install it](https://discord.com/download) on your computer and Android device.
+   - with Homebrew `brew install --cask discord`
+   - with Chocolatey `choco install discord`
+- If your preferred name differs significantly from your Discord "Display Name," click on "treehouses" in the upper left of the Discord interface. Then, select "Edit Server Profile" from the menu and update your server nickname to include your preferred name or first name and last name initial.
+
+## Contribute to Translations on Crowdin
+- We use Crowdin to translate our user interface into multiple languages.
+- If you know [a language supported by Planet](https://crowdin.com/project/ole-planet), your translation assistance would be greatly appreciated. Create a Crowdin account and aim to translate at least 10% of the words in your chosen language. For an overview of the functionality and terminology, refer to the [Planet User Manual](#!./pages/techgenius/tg-planet-user-manual.md). Your contributions will help both the project and enhance your understanding of Planet. Be sure to let us know in the [#vi-software channel](https://discord.com/channels/1079980988421132369/1229437557843169280) on Discord if you're able to contribute to our translation efforts.
+  - Let us know in our Discord server's vi-software channel if you are working on this
+
+#### Return to [First Steps](vi-first-steps.md#Step_0_-_Introductory_Step)
diff --git a/pages/vi/vi-myplanet.md b/pages/vi/vi-myplanet.md
@@ -1,4 +1,4 @@
-﻿# myPlanet Tutorial (Step 4.2)
+﻿# Step 4.2 - myPlanet Tutorial
 **Estimated Time: 1h** 
 
 **NOTE**: If you don't have access to an Android device, you may skip this step.
diff --git a/pages/vi/vi-nation.md b/pages/vi/vi-nation.md
@@ -1,4 +1,4 @@
-# Nation Planet (Step 7)
+# Step 7 - Nation Planet
 **Estimated Time: 2h**
 
 ## Objectives
diff --git a/pages/vi/vi-planet-configurations.md b/pages/vi/vi-planet-configurations.md
@@ -1,4 +1,4 @@
-﻿# Planet Configurations (Step 3.2)
+﻿# Step 3.2 - Planet Configurations
 **Estimated Time: 1.5h** 
 
 ## Objectives
diff --git a/pages/vi/vi-planetapps.md b/pages/vi/vi-planetapps.md
@@ -1,4 +1,4 @@
-﻿# Planet Tutorial (Step 4.1)
+﻿# Step 4.1 - Planet Tutorial
 **Estimated Time: 1h** 
 
 ## Objectives
diff --git a/pages/vi/vi-prerequisites.md b/pages/vi/vi-prerequisites.md
@@ -1,4 +1,4 @@
-# Software Prerequisites - Environment Setup (Step 2)
+# Step 2 - Software Prerequisites - Environment Setup
 **Estimated Time: 1.5h** 
 
 ## Objectives

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Connecting myPlanet to Planet`
	`1`	`+# Step 4 - Connecting myPlanet to Planet`
`2`	`2`
`3`	`3`	`## Background`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Take a Course on myPlanet, Courses Gardening`
	`1`	`+# Step 7 - Take a Course on myPlanet, Courses Gardening`
`2`	`2`
`3`	`3`	`## myPlanet App Dashboard and Courses Overview`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Create More Issues and Pull Requests (Step 8)`
	`1`	`+# Step 8 - Create More Issues and Pull Requests`
`2`	`2`	`Estimated Time: 4.5h`
`3`	`3`
`4`	`4`	`## Objectives`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Planet Development Setup Tutorial (Step 9)`
	`1`	`+# Step 9 - Planet Development Setup Tutorial`
`2`	`2`	`Estimated Time: 3h`
`3`	`3`
`4`	`4`	`## Objectives`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Docker Tutorial (Step 3.1)`
	`1`	`+# Step 3.1 - Docker Tutorial`
`2`	`2`	`Estimated Time: 1h`
`3`	`3`
`4`	`4`	`## Objectives`