You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+37-37Lines changed: 37 additions & 37 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,10 +1,10 @@
1
1
# Welcome to CONTRIBUTING.md
2
2
3
-
Hey there, fellow Developer !!!... I happy see, hyped about make your *, probably,* first contribution to this opensource repo. I heartily welcome you to your journey in open source contribution. I hope you have fun learning and teaching at the same time. For the **Notebook**, most of the contribution done will be related to the content writing like blogs, tip & trick, tech update, various documentation, etc.
3
+
Hey there, fellow Developer !!!... I am happy to see and hyped about making your *, probably,* first contribution to this open-source repo. I heartily welcome you to your journey in open source contribution. I hope you have fun learning and teaching at the same time. For the **Notebook**, most of the contribution will be related to content writing like blogs, tips & tricks, tech updates, various documentation, etc.
4
4
5
5
## Setting up Environment
6
6
7
-
Before you even start working on your content writing, make sure you've got the right environment installed to build the project locally... As this project based on Jekyll[^1] framework that is built upon `Ruby`. We need `Ruby`, `Bundler` and `jekyll`framework to build and test within local systems. The installation process is different from platform to platform, so make sure you following the instruction properly.
7
+
Before you even start working on your content writing, make sure you've got the right environment installed to build the project locally. As this project is based on Jekyll[^1] framework that is built upon `Ruby`. We need `Ruby`, `Bundler`, and `jekyll`frameworks to build and test within local systems. The installation process is different from platform to platform, so make sure you follow the instructions properly.
8
8
9
9
### For Ubuntu:
10
10
@@ -35,12 +35,12 @@ gem install jekyll bundler
35
35
```
36
36
37
37
> [!IMPORTANT]
38
-
> For Other Linux Distros, check the offical [Jekyll](https://jekyllrb.com/docs/installation/other-linux/"visit offical jekyll page for other linux installation") webpage. Also make sure, you have installed `bundler` along with jekyll using the follow command:
38
+
> For Other Linux Distros, check the offical [Jekyll](https://jekyllrb.com/docs/installation/other-linux/"visit offical jekyll page for other linux installation") webpage. Also make sure, you have installed `bundler` along with jekyll using the following command:
39
39
```bash
40
40
gem install bundler
41
41
```
42
42
43
-
- Use the following command to check whether the `bundler` and jekyll framework installed properly or not.
43
+
- Use the following command to check whether the `bundler` and jekyll framework are installed properly or not.
44
44
```bash
45
45
bundle info --path jekyll-theme-chirpy
46
46
```
@@ -51,17 +51,17 @@ bundle info --path jekyll-theme-chirpy
51
51
52
52
For Windows users, setting up the environment is a bit more involved:
53
53
54
-
- Start by downloading and installing the the `Ruby` using [RubyInstaller](https://rubyinstaller.org/downloads/"Download RubyInstaller"), choose the the latest one with Devkit with default options.
54
+
- Start by downloading and installing the `Ruby` using [RubyInstaller](https://rubyinstaller.org/downloads/"Download RubyInstaller"), and choose the latest one with Devkit with default options.
55
55
56
-
- At the end of installation, You'll get CMD asking you to enter option between 1-3. Enter 3 as input, then you can enter 2 if you want to update `MYSYS2` but that's totally optional. After all the installation is done, press enter to close the CMD prompt.
56
+
- At the end of the installation, You'll get CMD asking you to enter options between 1-3. Enter 3 as input, then you can enter 2 if you want to update `MYSYS2` but that's totally optional. After all the installation is done, press enter to close the CMD prompt.
- Open a new command prompt window from the start menu, Use the following command to check whether `Ruby` has properly installed and its `PATH`` has been set properly.
64
+
- Open a new command prompt window from the start menu, Use the following command to check whether `Ruby` has been properly installed and its `PATH`` has been set properly.
65
65
```powershell
66
66
ruby -v
67
67
```
@@ -71,7 +71,7 @@ ruby -v
71
71
gem install jekyll bundler
72
72
```
73
73
74
-
- Use the following command to check whether the `bundler` and jekyll framework installed properly or not.
74
+
- Use the following command to check whether the `bundler` and jekyll framework are installed properly or not.
75
75
```bash
76
76
bundle info --path jekyll-theme-chirpy
77
77
```
@@ -85,7 +85,7 @@ If you're on MacOS, follow these steps:
85
85
> [!ALERT]
86
86
> Ensure you have the [Homebrew](https://brew.sh/"Install Homebrew") package manager installed. If you're facing any issues while setting up the project in MacOS, check out the [Trobleshooting post](https://github.com/Grow-with-Open-Source/Notebook/discussions/3#discussioncomment-7151280) within the [Help Request](https://github.com/Grow-with-Open-Source/Notebook/discussions/3"Goto Help Request Discussion") discussion.
87
87
88
-
- Start by install`chruby` and `ruby-install` with Homebrew:
88
+
- Start by installing`chruby` and `ruby-install` with Homebrew:
89
89
```bash
90
90
brew install chruby ruby-install xz
91
91
```
@@ -114,7 +114,7 @@ ruby -v
114
114
gem install bundler jekyll
115
115
```
116
116
117
-
- Use the following command to check whether the `bundler` and jekyll framework installed properly or not.
117
+
- Use the following command to check whether the `bundler` and jekyll framework are installed properly or not.
118
118
```bash
119
119
bundle info --path jekyll-theme-chirpy
120
120
```
@@ -152,19 +152,19 @@ bundle exec jekyll s
152
152
bundler exec jekyll s --incremental
153
153
```
154
154
155
-
- If project build is successful, then you can view the project build that is hosted through your [localhost:4000/Notebook](http://127.0.0.1:4000/Notebook/). Well done, you have successfully setted up the project within your local system.
155
+
- If the project build is successful, then you can view the project build that is hosted through your [localhost:4000/Notebook](http://127.0.0.1:4000/Notebook/). Well done, you have successfully set up the project within your local system.
156
156
157
157
## Getting Started with Contribution
158
158
159
-
Now that you setted up the environment required and started analyzing the project, you have to know a few things about the project structure and its configuration before you started working on you content writing.
159
+
Now that you set up the environment required and started analyzing the project, you have to know a few things about the project structure and its configuration before you start working on your content writing.
160
160
161
161
### Instructions and Guidelines
162
162
163
-
- All of the content writing will be done in Markdown *(`.md`)* file format. So, Make yourself more comfortable Markdown sytnax through [Offical GitHub Documentation](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github"visit the offical GitHub Docs").
163
+
- All of the content writing will be done in Markdown *(`.md`)* file format. So, Make yourself more comfortable with Markdown syntax through [Offical GitHub Documentation](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github"visit the offical GitHub Docs").
164
164
165
-
- Since this open source is based chripy[^2] theme jekyll[^1] project, You're not limited by Markdown only. You can do much more using simple Markdown that provides easy of writing while supporting limited HTML elements. Check out the Chirpy-based [post creation](https://chirpy.cotes.page/posts/write-a-new-post/) and [text and typography](https://chirpy.cotes.page/posts/text-and-typography/) posts to know more.
165
+
- Since this open source is based chripy[^2] theme jekyll[^1] project, You're not limited by Markdown only. You can do much more using simple Markdown that provides easy writing while supporting limited HTML elements. Check out the Chirpy-based [post creation](https://chirpy.cotes.page/posts/write-a-new-post/) and [text and typography](https://chirpy.cotes.page/posts/text-and-typography/) posts to know more.
166
166
167
-
- You need to add you details to link the author details with the posts. You can add your author details to the **`_data/authors.yml`** file in the following format:
167
+
- You need to add your details to link the author's details with the posts. You can add your author details to the **`_data/authors.yml`** file in the following format:
168
168
```yaml
169
169
# Make sure the key_value is unique and not to be a duplicate
170
170
unique_key_value:
@@ -187,11 +187,11 @@ shamith_watchdogs:
187
187
<div>
188
188
</details>
189
189
190
-
- It is highly recommended to use the images though CDN links. But if for some reason you unable to do so, then store them in a new folder that is named after your post and save that folder within **`assets/img`** directory as **`assets/img/<your-project-name>/`**. Try avoid the process of *storing images within `assets/img` directory as it reflects the size of project.
190
+
- It is highly recommended to use the images through CDN links. But if for some reason you are unable to do so, then store them in a new folder that is named after your post and save that folder within **`assets/img`** directory as **`assets/img/<your-project-name>/`**. Try avoid the process of *storing images within `assets/img` directory as it reflects the size of the project.
191
191
192
192
- Place your content writing files within the **`_posts`** directory, following the naming convention **`YYYY-MM-DD-file-name.md`**, e.g., `2023-09-27-welcome-to-notebook.md`. **Use lowercase letters and separate words with a single dash.**
193
193
194
-
- Each and every content writing files should contain the following meta-data *(or)* configuration for the project to be successfully build:
194
+
- Each and every content writing file should contain the following meta-data *(or)* configuration for the project to be successfully built:
195
195
```md
196
196
---
197
197
title: <title>
@@ -231,22 +231,22 @@ image:
231
231
232
232
> [!IMPORTANT]
233
233
> - Note that the `+/-TTTT` in the `date` section refers the **UTC offset**. You can find your **UTC offset** value by searching for your country in the [list of UTC](https://en.wikipedia.org/wiki/List_of_UTC_offsets "Goto List of UTC offsets"). And if you're from India, you can use the above UTC offset from the example.
234
-
> - If there are more that one person/author working on a single post, then use `authors` attribute instread of `author`. Also the input for the `authors` attribute will be a list of unique_key_value represnting the authors.
234
+
> - If there is more than one person/author working on a single post, then use `authors` attribute instead of `author`. Also, the input for the `authors` attribute will be a list of unique_key_value representing the authors.
235
235
> - It's complete optional to have `img_path` and `image` attribute. Use them if and only if, your post requires any images.
236
236
> - If your post is using images and you have set the `img_path`, then you can directly access the images just by using their name.
237
237
> - The `image` attribute will act as the page cover or thumbnail for your post. It's up to you to add a page-cover or not.
238
238
239
-
These are the important instruction and guidelines you need follow for creating a successful post without any issue.
239
+
These are important instructions and guidelines you need to follow to create a successful post without any issues.
240
240
241
241
### Contributing
242
242
243
-
Now that you have basic understanding about the working of the project, let's talk a bit about process of contributing...
243
+
Now that you have a basic understanding of the workings of the project, let's talk a bit about the process of contributing...
244
244
245
245
**Step 1:** You start you setting up the environment [*(as discussed above)*](#setting-up-environment).
246
246
247
247
**Step 2:** After setting up the required environment, now build the project locally [*(as discussed above)*](#build-the-project-locally).
248
248
249
-
**Step 3:** Create a new branch to work on you contribution. use the following command:
249
+
**Step 3:** Create a new branch to work on your contribution. use the following command:
**Step 4:** Now that you got the project up and running within you local machine, start by adding your details as author to [`_data/authors.yml`](_data/authors.yml) file as [mention above](#instructions-and-guidelines). Make sure you author key is unique and different from others.
258
+
**Step 4:** Now that you got the project up and running within your local machine, start by adding your details as an author to [`_data/authors.yml`](_data/authors.yml) file as [mention above](#instructions-and-guidelines). Make sure your author key is unique and different from others.
259
259
260
-
**Step 5:** Now go ahead and create a new markdown file to work on post to contribute. Make sure you follow the naming convension for the file which is `YYYY-MM-DD-your-post-name`. And you post name should be all small alphanumeric separated by dashs *(-)*.
260
+
**Step 5:** Now go ahead and create a new markdown file to work on post to contribute. Make sure you follow the naming convention for the file which is `YYYY-MM-DD-your-post-name`. And you post name should be all small alphanumeric separated by dashs *(-)*.
261
261
262
-
**Step 6:** Make sure you commit every change it now, one commit for adding the author name and one for creating a new markdown file. Using the following command:
262
+
**Step 6:** Make sure you commit every change now, one commit for adding the author name and one for creating a new markdown file. Using the following command:
> Make sure to commit your each and every change with proper description
273
273
274
-
- **Step 7:** After creating the empty mark down file, add the required meta data *(or)* configuration as [mention above](#instructions-and-guidelines).
274
+
- **Step 7:** After creating the empty markdown file, add the required metadata *(or)* configuration as [mention above](#instructions-and-guidelines).
275
275
276
276
- **Step 8:** Now, proceed with your content writing using markdown syntax and also using additional features of Chirpy theme[^2].
277
277
278
-
- **Step 9:** If you have any images, try adding CDN links to the source containing all the images. If not, you can create a new directory using you posts name *(separated with dashes -)* within the `assets/img/` as `assets/img/<your-post-name>`. And also mention the CDN or directory path in `img_path` attribute as [mention above](#instructions-and-guidelines).
278
+
- **Step 9:** If you have any images, try adding CDN links to the source containing all the images. If not, you can create a new directory using your posts name *(separated with dashes -)* within the `assets/img/` as `assets/img/<your-post-name>`. And also mention the CDN or directory path in `img_path` attribute as [mention above](#instructions-and-guidelines).
279
279
280
-
- **Step 10 (optional):** After you done with you post *(don't forget to come each and every change)*, if you want you can add an page-cover (or) thumbnail to you post. Just mention the image name within the subattribute `path` of the main attribute `image`.
280
+
- **Step 10 (optional):** After you are done with your post *(don't forget to come with each and every change)*, if you want you can add a page-cover (or) thumbnail to your post. Just mention the image name within the sub-attribute `path` of the main attribute `image`.
281
281
282
-
- **Step 11:** After commit all the changes and completion of your work. push your commit to you forked repo, using the following commands:
282
+
- **Step 11:** After committing all the changes and completion of your work. push your commit to your forked repo, using the following commands:
- **Step 12:** Now, create a pull request to the [original repo](https://github.com/Grow-with-Open-Source/Notebook). [Learn about Pull requests](https://docs.github.com/articles/using-pull-requests "offical GitHub documentaiton")
292
292
293
-
And that it, you have done it !!!... Now, it's time for the maintainer to review you work and merge you pull request. If there's any issue with your pull request, then the maintainer will contact you and asks for a few changes. And he merges your Pull request, you have successfully did your first opensource contribution that actual help others.
293
+
And that is it, you have done it !!!... Now, it's time for the maintainer to review your work and merge your pull request. If there's any issue with your pull request, then the maintainer will contact you and ask for a few changes. And he merges your Pull request, you have successfully made your first open-source contribution that actually helps others.
294
294
295
-
Everybody can see you work and make use of it. Good job, mate !!...
295
+
Everybody can see your work and make use of it. Good job, mate !!...
296
296
297
297
## Rules and Regulations
298
298
299
299
Here are some ground rules that you need to follow:
300
300
301
-
- It's important for you to commit each and every change. Don't just finish all of your work with a single commit. If you're a newbie, it will only be tolerated for 3 times.
302
-
- Sending several pull request for a single post is not accepted.
303
-
- Your Pull Request will not be merged, if you have modified, changed or deleted any files or content that doesn't belong to you.
304
-
- Pull Request containing any illegal, NFSW or any other content which doesn't help other in anyway possible will be close immediately.
305
-
- The Pull Request will only be merged if you everything seem to be in order. You be notified if you did something wrong, and you pull request will only be merged if the notified changes are made.
301
+
- It's important for you to commit to each and every change. Don't just finish all of your work with a single commit. If you're a newbie, it will only be tolerated 3 times.
302
+
- Sending several pull requests for a single post is not accepted.
303
+
- Your Pull Request will not be merged, if you have modified, changed, or deleted any files or content that doesn't belong to you.
304
+
- Pull Request containing any illegal, NFSW or any other content which doesn't help others in any way possible will be closed immediately.
305
+
- The Pull Request will only be merged if everything seems to be in order. You be notified if you did something wrong, and your pull request will only be merged if the notified changes are made.
0 commit comments