Skip to content

Commit 837191b

Browse files
jaskiratsingh2000gitbook-bot
authored andcommittedOct 5, 2020
GitBook: [master] 54 pages modified
1 parent 3758f17 commit 837191b

File tree

4 files changed

+40
-1
lines changed

4 files changed

+40
-1
lines changed
 

‎SUMMARY.md

+2-1
Original file line numberDiff line numberDiff line change
@@ -63,5 +63,6 @@
6363

6464
* [Development](development/README.md)
6565
* [Contribution Worklfow](development/contribution-worklfow.md)
66-
* [Documentation](documentation.md)
66+
* [Documentation](documentation/README.md)
67+
* [Working with Changes](documentation/working-with-changes.md)
6768

‎documentation/README.md

+31
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# Documentation
2+
3+
So you're thinking of contributing to our documentation? Amazing! We really appreciate contributing to the docs because documentation plays an important role in any open source project to get started. So in order to chime in see something that needs fixing, or something that could be improved. Below you'll find some helpful guidelines to get you started, and to familiarize you with the approach we have been trying to follow.
4+
5+
{% hint style="info" %}
6+
NOTE: Our documentation is located and hosted on Gitbook. Link to the documentation - [**docs.codeuino.org**](https://docs.codeuino.og)\*\*\*\*
7+
{% endhint %}
8+
9+
In general, there are two main types of contributions:
10+
11+
* **General improvements**: typo corrections, fixing broken refs or links, correcting inaccurate or out-of-date information, and offering better explanations through clearer writing and additional examples.
12+
* **New features or new pages**: Adding a page of documentation that we haven't yet covered in our ongoing rewrite attempts as we move platforms, or documenting a new feature that has been added to Codeuino Projects since the last release.
13+
14+
### Before Contributing
15+
16+
**Understand that our documents are all released under a Creative Commons Attribution-ShareAlike 4.0 license** \([CC BY SA](http://creativecommons.org/licenses/by-sa/4.0/)\). This means that your contributions are being released to the Codeuino community to use, share, remix, and distribute as they see fit, provided any distribution takes place under the same licensing.
17+
18+
**Read through some of the documents we've already created**. You'll notice that there is a consistent structure to most of them, which we will describe in greater detail below. By reading through some of our existing documentation, you will get a feeling for the overall structure and style.
19+
20+
**Familiarize yourself with GitBook and Markdown.** As mentioned above that ****our documentation is hosted on the [**Gitbook**](https://www.gitbook.com/) platform and it is always suggested that you should get through the [**GitBook Docs**](https://docs.gitbook.com/) that demonstrate how to make edits or work with the gitbook platform.
21+
22+
**Make your contributions in the right place**. Are you contributing to the latest version of our docs, so that these improvements will be carried forward in the next version?
23+
24+
**Use the best resources and mindful thoughts while documenting.** You should make the documentation more impressive by adding Images, GIFs, Videos, etc.
25+
26+
{% hint style="info" %}
27+
**Source Citation:** [https://wiki.accesstomemory.org/wiki/Resources/Documentation/Contribution\_guidelines](https://wiki.accesstomemory.org/wiki/Resources/Documentation/Contribution_guidelines) under "Before Contributing" headline
28+
{% endhint %}
29+
30+
**Once you have read the "Before Contributing" section make sure you jump into the "Working with Changes" section**
31+

‎documentation/working-with-changes.md

+6
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
# Working with Changes
2+
3+
## Understanding GitBook's integration with GitHub
4+
5+
We use a platform called [GitBook](https://www.gitbook.com/) to host, manage and serve our documentation. GitBook fetches files from our GitHub repository Codeuino, reads them and converts them into the pages you can access on A generic structure of a documentation hosted on GitBook would look like this:
6+

‎meetings-notes.md

+1
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,7 @@
4646
* **LF Meet-5:** [**21-09-2020**](https://docs.google.com/document/d/1oQPiJy-FPenJtKDsmLG1is8NjElXT3GhQuqMlxd2J4Q/edit?usp=sharing)\*\*\*\*
4747
* **LF Meet-6:** [**24-09-2020**](https://docs.google.com/document/d/19hWFu5UHg-qrafWflEqxS9yJ6du8Xv_RSnyjQvl3CTY/edit)\*\*\*\*
4848
* **LF Meet-7:** [**01-10-2020**](https://docs.google.com/document/d/1GE4bVB81jE5Srw4lkxwtC15hjs_a6Eksn25tPNaNuNo/edit?usp=sharing)\*\*\*\*
49+
* **LF Meet-8:** [**05-10-2020**](https://docs.google.com/document/d/1LGEjbkGl90SqxvunRv8I9HbNONfUGLb0mvU4ZoIZ0kI/edit?usp=sharing)\*\*\*\*
4950

5051

5152

0 commit comments

Comments
 (0)