Thank you for your interest in utilizing this repository! This guide will walk you through the process of forking the repo, creating a Markdown file for your learning entry, and contributing it back to the repository while following the required guidelines.
To get started, you need to fork the original repository. Follow these steps:
- Visit the original repository at repo-link.
- Click the "Fork" button at the top-right corner of the page.
- This will create a copy of the repository in your GitHub account.
Now that you have your own copy of the repository, it's time to create a new Markdown file for your learning entry.
Run
npm run generate insert_title
insert_title = whatever will help you remember the initial title that you'd like to have as a keyword
This will generate the new markdown file in the correct space.
In the newly created Markdown file, document your learning experience using the following format:
# Learning Entry - Date
## Type of Learning: [Snippet / Learning / Tool / Language / Win / Bragging]
### What I've Learned:
[Write here what you've learned during your study, experiment, or exploration. Be as detailed and informative as possible.]
Replace `[Snippet / Learning / Tool / Language]` with the specific type of learning you had. For example, if you learned a new programming language, you can replace it with "Language." If it's a useful code snippet you discovered, use "Snippet," and so on.
Before pushing your changes to your forked repository, create a new branch with a descriptive name that indicates the type of learning and what it is about. Follow this naming convention:
{type of learning}/{what it is}
For example, if you learned a new Python library, your branch name could be `learning/python-library`. This naming convention will help keep the repository organized and make it easier for others to find relevant entries.
Once you have committed your changes to the new branch, push it to your forked repository. Then, navigate to the original repository on GitHub and create a new Pull Request (PR) with the following steps:
- Click on the "Pull Requests" tab in the original repository.
- Click the "New Pull Request" button.
- Select your forked repository and the branch you created from the dropdowns.
- Review the changes and create the pull request.
Finally, to help with the repository's organization, add a specific label to your Pull Request that corresponds to the type of learning you documented in your entry. For example, you can use labels like "Snippet," "Learning," "Tool," or "Language" based on your entry type.
That's it! You have successfully utilized the repository by forking, creating a new learning entry, and contributing it back following the required guidelines. Thank you for your contribution!