-
Notifications
You must be signed in to change notification settings - Fork 86
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #209 from crazyshrut/master
Create learn.md
- Loading branch information
Showing
1 changed file
with
146 additions
and
0 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 |
---|---|---|
@@ -0,0 +1,146 @@ | ||
## Table of Contents | ||
|
||
1. [What is the repo all about?](#what-is-the-repo-all-about) | ||
2. [What is the solution trying to solve?](#what-is-the-solution-trying-to-solve) | ||
3. [Contributing Guidelines π](#contributing-guidelines-) | ||
4. [Need some help regarding the basics? π€](#need-some-help-regarding-the-basics-) | ||
5. [Alternatively Contribute Using GitHub Desktop](#alternatively-contribute-using-github-desktop) | ||
6. [Issue Report Process π](#issue-report-process-) | ||
7. [Pull Request Process π](#pull-request-process-) | ||
8. [To Whom Should I Reach Out?](#to-whom-should-i-reach-out) | ||
9. [Tech Stack Used](#tech-stack-used) | ||
10. [How to Set Up on a Local System](#how-to-set-up-on-a-local-system) | ||
|
||
|
||
## What is the repo all about? | ||
|
||
Learn is a simple learning app built using Flutter for kids. This app is designed to provide an engaging learning experience for children, covering a wide range of topics including: | ||
|
||
- *A-Z Alphabets* with examples and pronunciation. | ||
- *Animals* and their pronunciation along with their voices. | ||
- *Body parts* and their pronunciation with short information on various topics. | ||
- More exciting features are planned for future updates, such as birds and their voices, information on the solar system, knowledge of shapes, and much more! | ||
|
||
## What is the solution trying to solve? | ||
|
||
For children aged 2-5 years old, the app addresses the need for basic knowledge of their surroundings. Teachers often have to search for images and information individually, but this app provides a single, comprehensive resource where all images and categories are available in one place. Categories include: | ||
|
||
- A-Z | ||
- Birds | ||
- Body parts | ||
- Shapes | ||
- Solar system | ||
- Animals | ||
|
||
In addition to learning, the app offers quizzes and a speaking feature to help children learn how to pronounce various objects. | ||
|
||
## Contributing Guidelines π | ||
|
||
This documentation contains a set of guidelines to help you during the contribution process. We are happy to welcome all contributions from anyone willing to improve or add new scripts to this project. Thank you for helping out, and remember, no contribution is too small. | ||
|
||
Please note that we have a [Code of Conduct](https://github.com/VaibhavCodeClub/learn/blob/master/CODE_OF_CONDUCT.md) which we ask you to follow in all your interactions with the project. | ||
|
||
## Need some help regarding the basics? π€ | ||
|
||
You can refer to the following articles on the basics of Git and GitHub, and also contact the Project Mentors if you are stuck: | ||
|
||
- [Forking a Repo](https://help.github.com/en/github/getting-started-with-github/fork-a-repo) | ||
- [Cloning a Repo](https://help.github.com/en/desktop/contributing-to-projects/creating-an-issue-or-pull-request) | ||
- [How to Create a Pull Request](https://opensource.com/article/19/7/create-pull-request-github) | ||
- [Getting Started with Git and GitHub](https://towardsdatascience.com/getting-started-with-git-and-github-6fcd0f2d4ac6) | ||
- [Learn GitHub from Scratch](https://docs.github.com/en/get-started/start-your-journey/git-and-github-learning-resources) | ||
|
||
## Alternatively Contribute Using GitHub Desktop | ||
|
||
1. *Open GitHub Desktop:* | ||
- Launch GitHub Desktop and log in to your GitHub account if you haven't already. | ||
|
||
2. *Clone the Repository:* | ||
- If you haven't cloned the repository yet, click on the "File" menu and select "Clone Repository." | ||
- Choose the repository from the list of repositories on GitHub and clone it to your local machine. | ||
|
||
3. *Switch to the Correct Branch:* | ||
- Ensure you are on the branch that you want to submit a pull request for. | ||
- If you need to switch branches, click on the "Current Branch" dropdown menu and select the desired branch. | ||
|
||
4. *Make Changes:* | ||
- Make your changes to the code or files in the repository using your preferred code editor. | ||
|
||
5. *Commit Changes:* | ||
- In GitHub Desktop, you'll see a list of the files you've changed. Check the box next to each file you want to include in the commit. | ||
- Enter a summary and description for your changes in the "Summary" and "Description" fields, respectively. Click the "Commit to" button to commit your changes to the local branch. | ||
|
||
6. *Push Changes to GitHub:* | ||
- After committing your changes, click the "Push origin" button in the top right corner of GitHub Desktop to push your changes to your forked repository on GitHub. | ||
|
||
7. *Create a Pull Request:* | ||
- Go to the GitHub website and navigate to your fork of the repository. | ||
- You should see a button to "Compare & pull request" between your fork and the original repository. Click on it. | ||
|
||
8. *Review and Submit:* | ||
- On the pull request page, review your changes and add any additional information, such as a title and description, that you want to include with your pull request. | ||
- Once you're satisfied, click the "Create pull request" button to submit your pull request. | ||
|
||
9. *Wait for Review:* | ||
- Your pull request will now be available for review by the project maintainers. They may provide feedback or ask for changes before merging your pull request into the main branch of the repository. | ||
|
||
## Issue Report Process π | ||
|
||
1. Go to the project's issues. | ||
2. Provide a proper description for the issue. | ||
3. Avoid spamming to get the assignment of the issue π. | ||
4. Wait until someone is looking into it. | ||
5. Start working on the issue only after you are assigned to it π. | ||
|
||
## Pull Request Process π | ||
|
||
1. Ensure that you have self-reviewed your code π. | ||
2. Make sure you have added a proper description for the functionality of the code. | ||
3. Comment your code, particularly in hard-to-understand areas. | ||
4. Add screenshots to help in the review. | ||
5. Submit your PR by providing the necessary information in the PR template and hang tight; we will review it really soon π. | ||
|
||
## To Whom Should I Reach Out? | ||
|
||
For inquiries, you can reach out to: | ||
- [Vaibhav Sapate](https://github.com/sapatevaibhav) | ||
- Email: sapatevaibhav@duck.com | ||
|
||
## Tech Stack Used | ||
|
||
- Dart | ||
- C++ | ||
- CMake | ||
- Swift | ||
- HTML | ||
- C | ||
- Flutter | ||
|
||
## How to Set Up on a Local System | ||
|
||
1. *Open GitHub Desktop:* | ||
- Launch GitHub Desktop and log in to your GitHub account if you haven't already. | ||
|
||
2. *Clone the Repository:* | ||
- If you haven't cloned the repository yet, click on the "File" menu and select "Clone Repository." | ||
- Choose the repository from the list of repositories on GitHub and clone it to your local machine. | ||
|
||
3. *Download Flutter:* | ||
- Ensure you have Flutter installed. If not, follow the instructions on [Flutter.dev](https://flutter.dev) to get it installed on your machine. | ||
|
||
4. *Navigate to the Project Directory:* | ||
- Use the terminal to navigate to the project directory. | ||
|
||
5. *Fetch Dependencies:* | ||
- Run the following command to fetch the dependencies: | ||
bash | ||
flutter pub get | ||
|
||
|
||
6. *Run the App:* | ||
- Once the dependencies are fetched, run the app on your preferred device using: | ||
bash | ||
flutter run | ||
|
||
|
||
That's it! The app should now be running on your device/emulator. |