Skip to content

Commit

Permalink
Fix a number of discovered typos, capitalization of developer and
Browse files Browse the repository at this point in the history
product names, plus a couple of instances of bad Markdown markup.
  • Loading branch information
Ewan Edwards committed Feb 3, 2015
1 parent e6e3370 commit ad6c372
Show file tree
Hide file tree
Showing 28 changed files with 72 additions and 72 deletions.
2 changes: 1 addition & 1 deletion doc/api/issues.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ Parameters:
"title": "v1.0",
"description": "",
"due_date": "2012-07-20",
"state": "reopenend",
"state": "reopened",
"updated_at": "2012-07-04T13:42:48Z",
"created_at": "2012-07-04T13:42:48Z"
},
Expand Down
6 changes: 3 additions & 3 deletions doc/api/oauth2.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ OAuth2 is a protocol that enables us to get access to private details of user's

Before using the OAuth2 you should create an application in user's account. Each application getting unique App ID and App Secret parameters. You should not share them.

This functianolity is based on [doorkeeper gem](https://github.com/doorkeeper-gem/doorkeeper)
This functionality is based on [doorkeeper gem](https://github.com/doorkeeper-gem/doorkeeper)

## Web Application Flow

Expand All @@ -15,7 +15,7 @@ This flow consists from 3 steps.

### 1. Registering the client

Creat an application in user's account profile.
Create an application in user's account profile.

### 2. Requesting authorization

Expand Down Expand Up @@ -96,4 +96,4 @@ For testing you can use the oauth2 ruby gem:
client = OAuth2::Client.new('the_client_id', 'the_client_secret', :site => "http://example.com")
access_token = client.password.get_token('user@example.com', 'sekret')
puts access_token.token
```
```
2 changes: 1 addition & 1 deletion doc/api/projects.md
Original file line number Diff line number Diff line change
Expand Up @@ -541,7 +541,7 @@ Parameters:
}
],
"tree": "c68537c6534a02cc2b176ca1549f4ffa190b58ee",
"message": "give caolan credit where it's due (up top)",
"message": "give Caolan credit where it's due (up top)",
"author": {
"name": "Jeremy Ashkenas",
"email": "jashkenas@example.com"
Expand Down
14 changes: 7 additions & 7 deletions doc/api/services.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,23 +23,23 @@ Delete GitLab CI service settings for a project.
DELETE /projects/:id/services/gitlab-ci
```

## Hipchat
## HipChat

### Edit Hipchat service
### Edit HipChat service

Set Hipchat service for project.
Set HipChat service for project.

```
PUT /projects/:id/services/hipchat
```
Parameters:

- `token` (required) - Hipchat token
- `room` (required) - Hipchat room name
- `token` (required) - HipChat token
- `room` (required) - HipChat room name

### Delete Hipchat service
### Delete HipChat service

Delete Hipchat service for a project.
Delete HipChat service for a project.

```
DELETE /projects/:id/services/hipchat
Expand Down
10 changes: 5 additions & 5 deletions doc/development/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,8 @@ You can imagine GitLab as a physical office.
They can be stored in a warehouse.
This can be either a hard disk, or something more complex, such as a NFS filesystem;

**NginX** acts like the front-desk.
Users come to NginX and request actions to be done by workers in the office;
**Nginx** acts like the front-desk.
Users come to Nginx and request actions to be done by workers in the office;

**The database** is a series of metal file cabinets with information on:
- The goods in the warehouse (metadata, issues, merge requests etc);
Expand Down Expand Up @@ -70,7 +70,7 @@ To summarize here's the [directory structure of the `git` user home directory](.

ps aux | grep '^git'

GitLab has several components to operate. As a system user (i.e. any user that is not the `git` user) it requires a persistent database (MySQL/PostreSQL) and redis database. It also uses Apache httpd or nginx to proxypass Unicorn. As the `git` user it starts Sidekiq and Unicorn (a simple ruby HTTP server running on port `8080` by default). Under the GitLab user there are normally 4 processes: `unicorn_rails master` (1 process), `unicorn_rails worker` (2 processes), `sidekiq` (1 process).
GitLab has several components to operate. As a system user (i.e. any user that is not the `git` user) it requires a persistent database (MySQL/PostreSQL) and redis database. It also uses Apache httpd or Nginx to proxypass Unicorn. As the `git` user it starts Sidekiq and Unicorn (a simple ruby HTTP server running on port `8080` by default). Under the GitLab user there are normally 4 processes: `unicorn_rails master` (1 process), `unicorn_rails worker` (2 processes), `sidekiq` (1 process).

### Repository access

Expand Down Expand Up @@ -146,13 +146,13 @@ nginx

Apache httpd

- [Explanation of apache logs](http://httpd.apache.org/docs/2.2/logs.html).
- [Explanation of Apache logs](http://httpd.apache.org/docs/2.2/logs.html).
- `/var/log/apache2/` contains error and output logs (on Ubuntu).
- `/var/log/httpd/` contains error and output logs (on RHEL).

redis

- `/var/log/redis/redis.log` there are also logrotated logs there.
- `/var/log/redis/redis.log` there are also log-rotated logs there.

PostgreSQL

Expand Down
2 changes: 1 addition & 1 deletion doc/development/ci_setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ We use [these build scripts](https://gitlab.com/gitlab-org/gitlab-ci/blob/master
# Build configuration on [Semaphore](https://semaphoreapp.com/gitlabhq/gitlabhq/) for testing the [GitHub.com repo](https://github.com/gitlabhq/gitlabhq)

- Language: Ruby
- Ruby verion: 2.1.2
- Ruby version: 2.1.2
- database.yml: pg

Build commands
Expand Down
2 changes: 1 addition & 1 deletion doc/install/requirements.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
- Ubuntu
- Debian
- CentOS
- RedHat Enterprise Linux (please use the CentOS packages and instructions)
- Red Hat Enterprise Linux (please use the CentOS packages and instructions)
- Scientific Linux (please use the CentOS packages and instructions)
- Oracle Linux (please use the CentOS packages and instructions)

Expand Down
2 changes: 1 addition & 1 deletion doc/integration/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Jenkins support is [available in GitLab EE](http://doc.gitlab.com/ee/integration

## Project services

Integration with services such as Campfire, Flowdock, Gemnasium, HipChat, PivotalTracker and Slack are available in the from of a Project Service.
Integration with services such as Campfire, Flowdock, Gemnasium, HipChat, Pivotal Tracker, and Slack are available in the form of a Project Service.
You can find these within GitLab in the Services page under Project Settings if you are at least a master on the project.
Project Services are a bit like plugins in that they allow a lot of freedom in adding functionality to GitLab, for example there is also a service that can send an email every time someone pushes new commits.
Because GitLab is open source we can ship with the code and tests for all plugins.
Expand Down
2 changes: 1 addition & 1 deletion doc/integration/external-issue-tracker.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ GitLab has a great issue tracker but you can also use an external issue tracker
- clicking 'New issue' on the project dashboard creates a new JIRA issue;
- To reference JIRA issue PROJECT-1234 in comments, use syntax PROJECT-1234. Commit messages get turned into HTML links to the corresponding JIRA issue.

![jira screenshot](jira-integration-points.png)
![Jira screenshot](jira-integration-points.png)

You can configure the integration in the gitlab.yml configuration file.

Expand Down
4 changes: 2 additions & 2 deletions doc/integration/gitlab_buttons_in_gmail.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# GitLab buttons in gmail
# GitLab buttons in Gmail

GitLab supports [Google actions in email](https://developers.google.com/gmail/markup/actions/actions-overview).

Expand All @@ -25,4 +25,4 @@ If you receive "No errors detected" message from the tester you can send the ema

```bash
bundle exec rake gitlab:mail_google_schema_whitelisting RAILS_ENV=production SEND=true
``
```
8 changes: 4 additions & 4 deletions doc/integration/shibboleth.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,15 @@

This documentation is for enabling shibboleth with gitlab-omnibus package.

In order to enable Shibboleth support in gitlab we need to use Apache instead of Nginx (It may be possible to use Nginx, however I did not found way to easily configure nginx that is bundled in gitlab-omnibus package). Apache uses mod_shib2 module for shibboleth authentication and can pass attributes as headers to omniauth-shibboleth provider.
In order to enable Shibboleth support in gitlab we need to use Apache instead of Nginx (It may be possible to use Nginx, however I did not found way to easily configure Nginx that is bundled in gitlab-omnibus package). Apache uses mod_shib2 module for shibboleth authentication and can pass attributes as headers to omniauth-shibboleth provider.


To enable the Shibboleth OmniAuth provider you must:

1. Configure Apache shibboleth module. Installation and configuration of module it self is out of scope of this document.
Check https://wiki.shibboleth.net/ for more info.

1. You can find Apache config in gitlab-reciepes (https://github.com/gitlabhq/gitlab-recipes/blob/master/web-server/apache/gitlab-ssl.conf)
1. You can find Apache config in gitlab-recipes (https://github.com/gitlabhq/gitlab-recipes/blob/master/web-server/apache/gitlab-ssl.conf)

Following changes are needed to enable shibboleth:

Expand All @@ -34,7 +34,7 @@ protect omniauth-shibboleth callback URL:
```
exclude shibboleth URLs from rewriting, add "RewriteCond %{REQUEST_URI} !/Shibboleth.sso" and "RewriteCond %{REQUEST_URI} !/shibboleth-sp", config should look like this:
```
#apache equivalent of nginx try files
# Apache equivalent of Nginx try files
RewriteEngine on
RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_URI} !/Shibboleth.sso
Expand All @@ -50,7 +50,7 @@ File it should look like this:
external_url 'https://gitlab.example.com'
gitlab_rails['internal_api_url'] = 'https://gitlab.example.com'
# disable nginx
# disable Nginx
nginx['enable'] = false
gitlab_rails['omniauth_allow_single_sign_on'] = true
Expand Down
6 changes: 3 additions & 3 deletions doc/markdown/markdown.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

* [Newlines](#newlines)
* [Multiple underscores in words](#multiple-underscores-in-words)
* [URL autolinking](#url-autolinking)
* [URL auto-linking](#url-autolinking)
* [Code and Syntax Highlighting](#code-and-syntax-highlighting)
* [Emoji](#emoji)
* [Special GitLab references](#special-gitlab-references)
Expand Down Expand Up @@ -40,7 +40,7 @@ You can use GFM in
- milestones
- wiki pages

You can also use other rich text files in GitLab. You might have to install a depency to do so. Please see the [github-markup gem readme](https://github.com/gitlabhq/markup#markups) for more information.
You can also use other rich text files in GitLab. You might have to install a dependency to do so. Please see the [github-markup gem readme](https://github.com/gitlabhq/markup#markups) for more information.

## Newlines

Expand Down Expand Up @@ -68,7 +68,7 @@ It is not reasonable to italicize just _part_ of a word, especially when you're
perform_complicated_task
do_this_and_do_that_and_another_thing

## URL autolinking
## URL auto-linking

GFM will autolink standard URLs you copy and paste into your text. So if you want to link to a URL (instead of a textural link), you can simply put the URL in verbatim and it will be turned into a link to that URL.

Expand Down
10 changes: 5 additions & 5 deletions doc/project_services/project_services.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,16 +4,16 @@ __Project integrations with external services for continuous integration and mor

## Services

- Assemblia
- [Atlassian Bamboo CI](bamboo.md) An Atlassian product for continous integration.
- Assembla
- [Atlassian Bamboo CI](bamboo.md) An Atlassian product for continuous integration.
- Build box
- Campfire
- Emails on push
- Flowdock
- Gemnasium
- GitLab CI
- Hipchat
- PivotalTracker
- HipChat
- Pivotal Tracker
- Pushover
- Slack
- TeamCity
- TeamCity
8 changes: 4 additions & 4 deletions doc/raketasks/backup_restore.md
Original file line number Diff line number Diff line change
Expand Up @@ -214,19 +214,19 @@ This is recommended to reduce cron spam.
If your GitLab server contains a lot of Git repository data you may find the GitLab backup script to be too slow.
In this case you can consider using filesystem snapshots as part of your backup strategy.
Example: Amazone EBS
Example: Amazon EBS
> A GitLab server using omnibus-gitlab hosted on Amazon AWS.
> An EBS drive containing an ext4 filesystem is mounted at `/var/opt/gitlab`.
> In this case you could make an application backup by taking an EBS snapshot.
> The backup includes all repositories, uploads and Postgres data.
Example: LVM snapshots + Rsync
Example: LVM snapshots + rsync
> A GitLab server using omnibus-gitlab, with an LVM logical volume mounted at `/var/opt/gitlab`.
> Replicating the `/var/opt/gitlab` directory usign Rsync would not be reliable because too many files would change while Rsync is running.
> Replicating the `/var/opt/gitlab` directory using rsync would not be reliable because too many files would change while rsync is running.
> Instead of rsync-ing `/var/opt/gitlab`, we create a temporary LVM snapshot, which we mount as a read-only filesystem at `/mnt/gitlab_backup`.
> Now we can have a longer running Rsync job which will create a consistent replica on the remote server.
> Now we can have a longer running rsync job which will create a consistent replica on the remote server.
> The replica includes all repositories, uploads and Postgres data.
If you are running GitLab on a virtualized server you can possibly also create VM snapshots of the entire GitLab server.
Expand Down
2 changes: 1 addition & 1 deletion doc/release/howto_rc1.md
Original file line number Diff line number Diff line change
Expand Up @@ -104,7 +104,7 @@ bundle exec rake release["x.x.0.rc1"]
```

Now developers can use master for merging new features.
So you should use stable branch for future code chages related to release.
So you should use stable branch for future code changes related to release.


### 5. Release GitLab CI RC1
Expand Down
2 changes: 1 addition & 1 deletion doc/release/monthly.md
Original file line number Diff line number Diff line change
Expand Up @@ -207,7 +207,7 @@ __3. Tweet to blog__
Send out a tweet to share the good news with the world.
List the most important features and link to the blog post.

Proposed tweet "Release of GitLab X.X & CI Y.Y! FEATURE, FEATURE and FEATURE <link-to-blogpost> #gitlab"
Proposed tweet "Release of GitLab X.X & CI Y.Y! FEATURE, FEATURE and FEATURE &lt;link-to-blog-post&gt; #gitlab"

Consider creating a post on Hacker News.

Expand Down
2 changes: 1 addition & 1 deletion doc/security/information_exclusivity.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,6 @@ Git is a distributed version control system (DVCS).
This means that everyone that works with the source code has a local copy of the complete repository.
In GitLab every project member that is not a guest (so reporters, developers and masters) can clone the repository to get a local copy.
After obtaining this local copy the user can upload the full repository anywhere, including another project under their control or another server.
The consequense is that you can't build access controls that prevent the intentional sharing of source code by users that have access to the source code.
The consequence is that you can't build access controls that prevent the intentional sharing of source code by users that have access to the source code.
This is an inherent feature of a DVCS and all git management systems have this limitation.
Obviously you can take steps to prevent unintentional sharing and information destruction, this is why only some people are allowed to invite others and nobody can force push a protected branch.
8 changes: 4 additions & 4 deletions doc/system_hooks/system_hooks.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,8 @@ System hooks can be used, e.g. for logging or changing information in a LDAP ser
"name": "StoreCloud",
"owner_email": "johnsmith@gmail.com",
"owner_name": "John Smith",
"path": "stormcloud",
"path_with_namespace": "jsmith/stormcloud",
"path": "storecloud",
"path_with_namespace": "jsmith/storecloud",
"project_id": 74,
"project_visibility": "private",
}
Expand Down Expand Up @@ -126,10 +126,10 @@ System hooks can be used, e.g. for logging or changing information in a LDAP ser
{
"created_at": "2012-07-21T07:30:54Z",
"event_name": "group_create",
"name": "StormCloud",
"name": "StoreCloud",
"owner_email": "johnsmith@gmail.com",
"owner_name": "John Smith",
"path": "stormcloud",
"path": "storecloud",
"group_id": 78
}
```
Expand Down
14 changes: 7 additions & 7 deletions doc/update/2.6-to-3.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,29 +22,29 @@ sudo -u gitlab bundle exec rake db:migrate RAILS_ENV=production
# !!! Config should be replaced with a new one. Check it after replace
cp config/gitlab.yml.example config/gitlab.yml

# update gitolite hooks
# update Gitolite hooks

# GITOLITE v2:
# Gitolite v2:
sudo cp ./lib/hooks/post-receive /home/git/share/gitolite/hooks/common/post-receive
sudo chown git:git /home/git/share/gitolite/hooks/common/post-receive

# GITOLITE v3:
# Gitolite v3:
sudo cp ./lib/hooks/post-receive /home/git/.gitolite/hooks/common/post-receive
sudo chown git:git /home/git/.gitolite/hooks/common/post-receive

# set valid path to hooks in gitlab.yml in git_host section
# like this
git_host:
# gitolite 2
# Gitolite 2
hooks_path: /home/git/share/gitolite/hooks
# gitolite 3
# Gitolite 3
hooks_path: /home/git/.gitolite/hooks/


# Make some changes to gitolite config
# Make some changes to Gitolite config
# For more information visit https://github.com/gitlabhq/gitlabhq/pull/1719

# gitolite v2
# Gitolite v2
sudo -u git -H sed -i 's/\(GL_GITCONFIG_KEYS\s*=>*\s*\).\{2\}/\\1"\.\*"/g' /home/git/.gitolite.rc

# gitlite v3
Expand Down
6 changes: 3 additions & 3 deletions doc/update/4.2-to-5.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -111,7 +111,7 @@ sudo chmod -R u+rwX /home/git/gitlab/tmp/pids

```

## 6. Update init.d script and nginx config
## 6. Update init.d script and Nginx config

```bash
# init.d
Expand All @@ -123,7 +123,7 @@ sudo chmod +x /etc/init.d/gitlab
sudo -u git -H cp /home/git/gitlab/config/unicorn.rb /home/git/gitlab/config/unicorn.rb.old
sudo -u git -H cp /home/git/gitlab/config/unicorn.rb.example /home/git/gitlab/config/unicorn.rb

#nginx
# Nginx
# Replace path from '/home/gitlab/' to '/home/git/'
sudo vim /etc/nginx/sites-enabled/gitlab
sudo service nginx restart
Expand All @@ -137,7 +137,7 @@ sudo service gitlab start
# check if unicorn and sidekiq started
# If not try to logout, also check replaced path from '/home/gitlab/' to '/home/git/'
# in nginx, unicorn, init.d etc
# in Nginx, unicorn, init.d etc
ps aux | grep unicorn
ps aux | grep sidekiq
Expand Down
2 changes: 1 addition & 1 deletion doc/update/5.1-to-6.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ sudo -u git -H bundle exec rake gitlab:backup:create RAILS_ENV=production

The migrations in this update are very sensitive to incomplete or inconsistent data. If you have a long-running GitLab installation and some of the previous upgrades did not work out 100% correct this may bite you now. The following can help you have a more smooth upgrade.

### Find projets with invalid project names
### Find projects with invalid project names

#### MySQL
Login to MySQL:
Expand Down
2 changes: 1 addition & 1 deletion doc/update/6.1-to-6.2.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ sudo -u git -H git checkout v1.7.9 # Addresses multiple critical security vulner
## 4. Install additional packages

```bash
# Add support for lograte for better log file handling
# Add support for logrotate for better log file handling
sudo apt-get install logrotate
```

Expand Down
Loading

0 comments on commit ad6c372

Please sign in to comment.