Skip to content

Commit 194934d

Browse files
committed
add contributing guidelines to top level README
1 parent cc4dfdd commit 194934d

File tree

9 files changed

+73
-9
lines changed

9 files changed

+73
-9
lines changed

README.md

Lines changed: 57 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,57 @@
1-
# curriculum-backend-readings
1+
# Backend Curriculum Readings
2+
This serves as a content monorepo for all the readings of the backend bootcamp curriculum developed by Re:Coded. Content from this repo will be transferred to the course on Canvas LMS. Each markdown file inside the module folders and sub-folders corresponds to a reading on the LMS.
3+
4+
## Folder Structure
5+
```
6+
.
7+
│ README.md // We are here
8+
9+
└───module1-introduction-to-backend
10+
| └───assets // common assets folder for module
11+
│ └───r1-introduction-to-backend
12+
| | README.md // reading content goes here
13+
│ └───r1.1-beginners-guide-nodejs-npm
14+
| | README.md
15+
| └───r2-http-and-rest
16+
| | README.md
17+
| └───r2.1-diving-into-rest-apis
18+
| | README.md
19+
| └───... // and so on
20+
|
21+
└───module2-database-technologies
22+
| └───assets // common assets folder for module
23+
│ └───r1-introduction-to-databases
24+
| | README.md // reading content goes here
25+
│ └───r2-introduction-to-relational-databases
26+
| | README.md
27+
| └───r2.1-relational-database-structure
28+
| | README.md
29+
| └───... // and so on
30+
|
31+
└───... // and so on
32+
```
33+
34+
## Folder naming Conventions
35+
36+
- For every new reading, name the folder as: `r[number]-name-of-reading`. For example, `r1-introduction-to-backend` or `r2.1-relational-database-structure`.
37+
- Use your discretion to shorten certain folder names if required while maintaining the same meaning. For example, the folder for "Beginners guide to Node.js and NPM" can be named as `r1.1-beginners-guide-nodejs-npm`.
38+
39+
## Reading format
40+
41+
- Each reading should begin with the title as an h1.
42+
- Below the title it should have the summary and learning goals.
43+
- After this goes in the main content of the reading.
44+
- Finally each reading should conclude with a section called Resources, where we can link the external blogs/tutorials/videos we referred to.
45+
46+
## General formatting Conventions
47+
48+
- Use proper header hierarchy (h1 # to h6 ######) to convey the flow of topics and sub-topics.
49+
- Use code and syntax highlighting for code blocks and referring variable/function names.
50+
- Use tables and lists for non-code content blocks.
51+
- Always share links through inline links. For example, check out [this markdown cheatsheet](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) is preferred over check out this markdown cheatsheet: https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet
52+
53+
54+
## Peer review process
55+
- Work on a module or reading on it's own branch and open a PR into main branch.
56+
- Request at least 2 reviewers on your PRs.
57+
- Open draft PRs early for large modules to get continuous peer reviews. This helps your peers know that the PR is still WIP and is also helpful to review the content in chunks.
Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,2 @@
1-
# curriculum-backend-readings
1+
# curriculum-backend-readings
2+
Temporary file for git tracking, to be deleted once this assets folder is populated
Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,2 @@
1-
# curriculum-backend-readings
1+
# curriculum-backend-readings
2+
Temporary file for git tracking, to be deleted once this assets folder is populated
Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,2 @@
1-
# curriculum-backend-readings
1+
# curriculum-backend-readings
2+
Temporary file for git tracking, to be deleted once this assets folder is populated
Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,2 @@
1-
# curriculum-backend-readings
1+
# curriculum-backend-readings
2+
Temporary file for git tracking, to be deleted once this assets folder is populated

module5-testing/assets/README.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,2 @@
1-
# curriculum-backend-readings
1+
# curriculum-backend-readings
2+
Temporary file for git tracking, to be deleted once this assets folder is populated
Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,2 @@
1-
# curriculum-backend-readings
1+
# curriculum-backend-readings
2+
Temporary file for git tracking, to be deleted once this assets folder is populated
Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,2 @@
1-
# curriculum-backend-readings
1+
# curriculum-backend-readings
2+
Temporary file for git tracking, to be deleted once this assets folder is populated

module8-typescript/assets/README.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,2 @@
1-
# curriculum-backend-readings
1+
# curriculum-backend-readings
2+
Temporary file for git tracking, to be deleted once this assets folder is populated

0 commit comments

Comments
 (0)