Skip to content

Commit 3c8ca34

Browse files
committed
first commit with added docs folder and files
1 parent c7d0233 commit 3c8ca34

6 files changed

+113
-0
lines changed

docs/README.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
# Contributing to the LearnOSM Guide
2+
3+
## Contribution Workflow
4+
Learn how to set up GitHub & Git, set up a local copy of the LearnOSM site, make changes and submit pull requests using GitHub and Git on the command line or GitHub Desktop.
5+
6+
## Contribution Guidelines
7+
Translations, Documentation Style Guide, Formatting files with Markdown and Jekyll
8+
__________________
9+
10+
## Contribution Workflow
11+
12+
### Step 0: Getting started with GitHub & Git
13+
- To get started you must create a GitHub account and install Git on your command line.
14+
15+
### [Step 1: Setting up a local copy of the LearnOSM site on your computer]()
16+
- To set up a local copy of the [LearnOSM](learnosm.org) site on your computer so you can preview the changes you have made, you must create a copy (or fork) of the site through your GitHub account and then add it to your computer using Git on the command line.
17+
18+
### [Step 2: Syncing your local copy of LearnOSM and managing your branches](docs/syncing-your-local-copy-of-learnosm-and-managing-your-branches)
19+
- Sync your local site with the original one and learn the best practices for preparing changes by managing your Git branches.
20+
21+
### Step 3: Making changes and submitting pull requests
22+
- Submit pull requests to the main LearnOSM site for review.
23+
24+
____________
25+
26+
## Contribution Guidelines
27+
28+
### Translations
29+
- See the [Translations guide]() for more details on translating.
30+
31+
### Documentation Style Guide
32+
- See the working document in []()
33+
34+
### Formatting files with Markdown and Jekyll
35+
- Jekyll uses a front matter at the top of each Markdown file to track how to make changes.
36+
37+
Improve this guide.

docs/documentation-style-guide.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
## Documentation Style Guide
Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
## Step 0: Getting started with GitHub & Git
2+
- To get started you must create a GitHub account and set up Git on your command line.
3+
4+
### Create a GitHub account
5+
Sign up at [GitHub](https://github.com/) for your free account if you haven't already. Check out GitHub's ["Signing up for a new GitHub account"](https://help.github.com/articles/signing-up-for-a-new-github-account/) for more details.
6+
7+
### Install and set up Git
8+
Start setting up Git by configuring your email and user name by following [GitHub's setup instructions](https://help.github.com/articles/set-up-git/).
9+
10+
*Note: You only need to complete these steps once*
11+
12+
### **Next Steps:** Continue to [Step 1: Setting up a local copy of the LearnOSM site on your computer](/docs/step-1-setting-up-a-local-copy-of-the-LearnOSM-site-on-your-computer)
Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
## Step 1: Setting up a local copy of the LearnOSM site on your computer
2+
- To set up a local copy of the [LearnOSM](learnosm.org) site on your computer so you can preview the changes you have made, you must create a copy (or fork) of the site through your GitHub account and then add it to your computer using Git on the command line.
3+
4+
*Note: You only need to complete these steps once*
5+
6+
### Create a copy (fork) of the site through your GitHub account
7+
1. Navigate to the LearnOSM site repository at [`https://github.com/hotosm/learnosm`](https://github.com/hotosm/learnosm) on GitHub.
8+
9+
2. To create a copy of the site repository click the fork button in the right hand corner.
10+
![fork-example](http://www.developer.com/imagesvr_ce/6467/GitHub-Pull-image001.gif)
11+
12+
3. Next you should see GitHub making a copy of the main LearnOSM site repository owned by hotsom.
13+
![fork-copy-in-action](https://help.github.com/assets/images/site/fork-a-repo.gif)
14+
15+
Now, you should see your own copy or fork of the LearnOSM site repository on GitHub.
16+
17+
Check out GitHub's guide on [forking](https://help.github.com/articles/fork-a-repo/) if you need more help.
18+
19+
### Download your forked copy of the site to your computer
20+
You can download your copy of the site to your computer using the command line or GitHub Desktop. Either way to preview a local copy of your site you must use the command line but cloning your site with GitHub Desktop is easier.
21+
22+
#### Clone your site on the command line
23+
24+
1. Find the HTTPS URL and copy it to your clipboard.
25+
https://guides.github.com/activities/forking/
26+
27+
1. Open up your command line.
28+
29+
2. Navigate to the place on your computer where you want to store your local copy of the learnosm site. In this example we will save it in a folder or directory called opensource.
30+
- 2.1 Create a directory called "opensource" or whatever you prefer.
31+
```
32+
$ mkdir opensource
33+
```
34+
35+
- 2.2 Navigate into your new directory
36+
```
37+
$ cd opensource
38+
opensource$
39+
```
40+
41+
3. Download your forked copy of the site to your computer by running this command `git clone https://github.com/hotosm/learnosm.git` You should see the site download.
42+
43+
If you run into any problems check out GitHub's [Cloning a repository](https://help.github.com/articles/cloning-a-repository/) guide.
44+
45+
#### Clone your site sing GitHub Desktop
46+
47+
1. Install GitHub Desktop and authenticate to GitHub using the "[Setting up GitHub Desktop](https://help.github.com/desktop/guides/getting-started/setting-up-github-desktop/)" guide.
48+
49+
2. Save a copy of your learnosm fork by using the "[Cloning a repository from GitHub Desktop]( https://help.github.com/desktop/guides/contributing/cloning-a-repository-from-github-desktop/)" guide.
50+
51+
To open your local copy of the site in the command line, right click on the learnosm repository clone in the left corner and select "open in the terminal" or "open in the command prompt." You can also open your local copy of the site in a text editor such as Atom from right clicking on your repository in GitHub Desktop.
52+
53+
### Sync your local copy of the site respository with the original one at hotosm/learnosm
54+
1. On GitHub Navigate to the original [hotosm/learnosm]() repository
55+
56+
2. Copy the HTTPS URL at the top of the repository. You will use this as the upstream repository URL later on.
57+
- For an example see step 2 of this [Sync a fork](https://help.github.com/articles/fork-a-repo/#step-3-configure-git-to-sync-your-fork-with-the-original-spoon-knife-repository) guide.
58+
59+
3. If you haven not already, navigate to the place that you cloned your learnosm site on the command line.
60+
61+
4. To sync your local copy with hotosm/learnosm follow these steps for [Configuring a remote for a fork]() starting with step 2 and using `https://github.com/hotosm/learnosm.git` as your upstream repository URL.
62+
63+
### **Next Steps:** Continue to [Step 3: Preparing to submit changes ](/docs/step-3-setting-up-a-local-copy-of-the-LearnOSM-site-on-your-computer)

docs/syncing-your-local-copy-of-learnosm-and-managing-your-branches

Whitespace-only changes.

docs/translations.md

Whitespace-only changes.

0 commit comments

Comments
 (0)