diff options
author | Robert Schilling <rschilling@student.tugraz.at> | 2014-08-04 22:32:41 +0200 |
---|---|---|
committer | Robert Schilling <rschilling@student.tugraz.at> | 2014-08-07 10:27:54 +0200 |
commit | abdc4426486c6e6458c12ba49dd641d4c5ab257a (patch) | |
tree | b458a06a7513284a29b3e1f193431160512e6aa6 | |
parent | d4f5af820f2fdb442404804859c84d2ef21794d9 (diff) | |
download | gitlab-ce-abdc4426486c6e6458c12ba49dd641d4c5ab257a.tar.gz |
Fix spelling errors in doc, closes #7437
Further changes
-rw-r--r-- | doc/api/README.md | 6 | ||||
-rw-r--r-- | doc/api/branches.md | 2 | ||||
-rw-r--r-- | doc/api/repositories.md | 16 | ||||
-rw-r--r-- | doc/development/architecture.md | 14 | ||||
-rw-r--r-- | doc/install/installation.md | 18 | ||||
-rw-r--r-- | doc/integration/github.md | 2 | ||||
-rw-r--r-- | doc/public_access/public_access.md | 2 | ||||
-rw-r--r-- | doc/raketasks/backup_restore.md | 2 | ||||
-rw-r--r-- | doc/raketasks/maintenance.md | 4 | ||||
-rw-r--r-- | doc/release/monthly.md | 6 | ||||
-rw-r--r-- | doc/release/security.md | 2 | ||||
-rw-r--r-- | doc/update/4.2-to-5.0.md | 4 | ||||
-rw-r--r-- | doc/update/6.2-to-6.3.md | 4 | ||||
-rw-r--r-- | doc/update/6.6-to-6.7.md | 2 | ||||
-rw-r--r-- | doc/update/6.8-to-6.9.md | 4 | ||||
-rw-r--r-- | doc/update/6.9-to-7.0.md | 4 | ||||
-rw-r--r-- | doc/update/7.0-to-7.1.md | 4 | ||||
-rw-r--r-- | doc/workflow/groups.md | 4 | ||||
-rw-r--r-- | doc/workflow/project_features.md | 2 |
19 files changed, 51 insertions, 51 deletions
diff --git a/doc/api/README.md b/doc/api/README.md index e91d3af59d7..a0a9ba6f4b6 100644 --- a/doc/api/README.md +++ b/doc/api/README.md @@ -132,14 +132,14 @@ When listing resources you can pass the following parameters: ## id vs iid -When you work with API you may notice two similar fields in api entites: id and iid. The main difference between them is scope. Example: +When you work with API you may notice two similar fields in api entities: id and iid. The main difference between them is scope. Example: Issue: id: 46 iid: 5 -- id - is uniq across all Issues table. It used for any api calls. -- iid - is uniq only in scope of single project. When you browse issues or merge requests with Web UI - you see iid. +- id - is unique across all issues. It's used for any api call. +- iid - is unique only in scope of a single project. When you browse issues or merge requests with Web UI, you see iid. So if you want to get issue with api you use `http://host/api/v3/.../issues/:id.json`. But when you want to create a link to web page - use `http:://host/project/issues/:iid.json` diff --git a/doc/api/branches.md b/doc/api/branches.md index f695b48fe2f..090287133ce 100644 --- a/doc/api/branches.md +++ b/doc/api/branches.md @@ -174,7 +174,7 @@ Parameters: - `id` (required) - The ID of a project - `branch_name` (required) - The name of the branch -- `ref` (required) - Create branch from commit sha or existing branch +- `ref` (required) - Create branch from commit SHA or existing branch ```json { diff --git a/doc/api/repositories.md b/doc/api/repositories.md index 2539e3edbf9..7d6164a0819 100644 --- a/doc/api/repositories.md +++ b/doc/api/repositories.md @@ -49,7 +49,7 @@ Parameters: + `id` (required) - The ID of a project + `tag_name` (required) - The name of a tag -+ `ref` (required) - Create tag using commit sha, another tag name, or branch name. ++ `ref` (required) - Create tag using commit SHA, another tag name, or branch name. ```json [ @@ -129,7 +129,7 @@ Parameters: ## Raw file content -Get the raw file contents for a file by commit sha and path. +Get the raw file contents for a file by commit SHA and path. ``` GET /projects/:id/repository/blobs/:sha @@ -144,7 +144,7 @@ Parameters: ## Raw blob content -Get the raw file contents for a blob by blob sha. +Get the raw file contents for a blob by blob SHA. ``` GET /projects/:id/repository/raw_blobs/:sha @@ -153,7 +153,7 @@ GET /projects/:id/repository/raw_blobs/:sha Parameters: + `id` (required) - The ID of a project -+ `sha` (required) - The blob sha ++ `sha` (required) - The blob SHA ## Get file archive @@ -166,7 +166,7 @@ GET /projects/:id/repository/archive Parameters: + `id` (required) - The ID of a project -+ `sha` (optional) - The commit sha to download defaults to the tip of the default branch ++ `sha` (optional) - The commit SHA to download defaults to the tip of the default branch ## Compare branches, tags or commits @@ -177,15 +177,15 @@ GET /projects/:id/repository/compare Parameters: + `id` (required) - The ID of a project -+ `from` (required) - the commit sha or branch name -+ `to` (required) - the commit sha or branch name ++ `from` (required) - the commit SHA or branch name ++ `to` (required) - the commit SHA or branch name ``` GET /projects/:id/repository/compare?from=master&to=feature ``` -Response: +Response: ```json diff --git a/doc/development/architecture.md b/doc/development/architecture.md index 9d0d58b3db9..4624d9f60b6 100644 --- a/doc/development/architecture.md +++ b/doc/development/architecture.md @@ -22,7 +22,7 @@ To serve repositories over SSH there's an add-on application called gitlab-shell ![GitLab Diagram Overview](gitlab_diagram_overview.png) -A typical install of GitLab will be on Ubuntu Linux or RHEL/CentOS. It uses Nginx or Apache as a web front end to proxypass the Unicorn web server. By default, communication between Unicorn and the front end is via a Unix domain socket but forwarding requests via TCP is also supported. The web front end accesses `/home/git/gitlab/public` bypassing the Unicorn server to serve static pages, uploads (e.g. avatar images or attachments), and precompiled assets. GitLab serves web pages and a [GitLab API](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/api) using the Unicorn web server. It uses Sidekiq as a job queue which, in turn, uses redis as a non-persistent database backend for job information, meta data, and incomming jobs. +A typical install of GitLab will be on Ubuntu Linux or RHEL/CentOS. It uses Nginx or Apache as a web front end to proxypass the Unicorn web server. By default, communication between Unicorn and the front end is via a Unix domain socket but forwarding requests via TCP is also supported. The web front end accesses `/home/git/gitlab/public` bypassing the Unicorn server to serve static pages, uploads (e.g. avatar images or attachments), and precompiled assets. GitLab serves web pages and a [GitLab API](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/api) using the Unicorn web server. It uses Sidekiq as a job queue which, in turn, uses redis as a non-persistent database backend for job information, meta data, and incoming jobs. The GitLab web app uses MySQL or PostgreSQL for persistent database information (e.g. users, permissions, issues, other meta data). GitLab stores the bare git repositories it serves in `/home/git/repositories` by default. It also keeps default branch and hook information with the bare repository. `/home/git/gitlab-satellites` keeps checked out repositories when performing actions such as a merge request, editing files in the web interface, etc. @@ -38,7 +38,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 @@ -53,28 +53,28 @@ See the README for more information. The GitLab init script starts and stops Unicorn and Sidekiq. ``` -/etc/init.d/gitlab +/etc/init.d/gitlab Usage: service gitlab {start|stop|restart|reload|status} ``` Redis (key-value store/non-persistent database) ``` -/etc/init.d/redis +/etc/init.d/redis Usage: /etc/init.d/redis {start|stop|status|restart|condrestart|try-restart} ``` SSH daemon ``` -/etc/init.d/sshd +/etc/init.d/sshd Usage: /etc/init.d/sshd {start|stop|restart|reload|force-reload|condrestart|try-restart|status} ``` Web server (one of the following) ``` -/etc/init.d/httpd +/etc/init.d/httpd Usage: httpd {start|stop|restart|condrestart|try-restart|force-reload|reload|status|fullstatus|graceful|help|configtest} $ /etc/init.d/nginx @@ -84,7 +84,7 @@ Usage: nginx {start|stop|restart|reload|force-reload|status|configtest} Persistent database (one of the following) ``` -/etc/init.d/mysqld +/etc/init.d/mysqld Usage: /etc/init.d/mysqld {start|stop|status|restart|condrestart|try-restart|reload|force-reload} $ /etc/init.d/postgresql diff --git a/doc/install/installation.md b/doc/install/installation.md index f3d21ac4482..e502a3ed82c 100644 --- a/doc/install/installation.md +++ b/doc/install/installation.md @@ -86,7 +86,7 @@ Then select 'Internet Site' and press enter to confirm the hostname. ## 2. Ruby -The use of ruby version managers such as [RVM](http://rvm.io/), [rbenv](https://github.com/sstephenson/rbenv) or [chruby](https://github.com/postmodern/chruby) with GitLab in production frequently leads to hard to diagnose problems. For example, GitLab Shell is called from OpenSSH and having a version manager can prevent pushing and pulling over SSH. Version managers are not supported and we stronly advise everyone to follow the instructions below to use a system ruby. +The use of ruby version managers such as [RVM](http://rvm.io/), [rbenv](https://github.com/sstephenson/rbenv) or [chruby](https://github.com/postmodern/chruby) with GitLab in production frequently leads to hard to diagnose problems. For example, GitLab Shell is called from OpenSSH and having a version manager can prevent pushing and pulling over SSH. Version managers are not supported and we strongly advise everyone to follow the instructions below to use a system ruby. Remove the old Ruby 1.8 if present @@ -107,7 +107,7 @@ Install the Bundler Gem: ## 3. System Users -Create a `git` user for Gitlab: +Create a `git` user for GitLab: sudo adduser --disabled-login --gecos 'GitLab' git @@ -232,9 +232,9 @@ We recommend using a PostgreSQL database. For MySQL check [MySQL setup guide](da ### Install GitLab shell -GitLab Shell is an ssh access and repository management software developed specially for GitLab. +GitLab Shell is an SSH access and repository management software developed specially for GitLab. - # Go to the Gitlab installation folder: + # Go to the GitLab installation folder: cd /home/git/gitlab # Run the installation task for gitlab-shell (replace `REDIS_URL` if needed): @@ -269,7 +269,7 @@ And if you are installing with a non-default folder or user copy and edit the de sudo cp lib/support/init.d/gitlab.default.example /etc/default/gitlab -If you installed gitlab in another directory or as a user other than the default you should change these settings in /etc/default/gitlab. Do not edit /etc/init.d/gitlab as it will be changed on upgrade. +If you installed GitLab in another directory or as a user other than the default you should change these settings in `/etc/default/gitlab`. Do not edit `/etc/init.d/gitlab as it will be changed on upgrade. Make GitLab start on boot: @@ -372,7 +372,7 @@ If you want to connect the Redis server via socket, then use the "unix:" URL sch ### Custom SSH Connection -If you are running SSH on a non-standard port, you must change the gitlab user's SSH config. +If you are running SSH on a non-standard port, you must change the GitLab user's SSH config. # Add to /home/git/.ssh/config host localhost # Give your setup a name (here: override localhost) @@ -380,11 +380,11 @@ If you are running SSH on a non-standard port, you must change the gitlab user's port 2222 # Your port number hostname 127.0.0.1; # Your server name or IP -You also need to change the corresponding options (e.g. ssh_user, ssh_host, admin_uri) in the `config\gitlab.yml` file. +You also need to change the corresponding options (e.g. `ssh_user`, `ssh_host`, `admin_uri`) in the `config\gitlab.yml` file. ### LDAP authentication -You can configure LDAP authentication in config/gitlab.yml. Please restart GitLab after editing this file. +You can configure LDAP authentication in `config/gitlab.yml`. Please restart GitLab after editing this file. ### Using Custom Omniauth Providers @@ -422,4 +422,4 @@ If you have successfully set up a provider that is not shipped with GitLab itsel You can help others by reporting successful configurations and probably share a few insights or provide warnings for common errors or pitfalls by sharing your experience [in the public Wiki](https://github.com/gitlabhq/gitlab-public-wiki/wiki/Custom-omniauth-provider-configurations). -While we can't officially support every possible auth mechanism out there, we'd like to at least help those with special needs. +While we can't officially support every possible authentication mechanism out there, we'd like to at least help those with special needs. diff --git a/doc/integration/github.md b/doc/integration/github.md index b53a7c12857..714593d8266 100644 --- a/doc/integration/github.md +++ b/doc/integration/github.md @@ -37,7 +37,7 @@ To enable the GitHub OmniAuth provider you must register your application with G args: { scope: 'user:email' } } ``` -1. Change 'YOUR APP ID' to the client ID from the GitHub application page from step 7. +1. Change 'YOUR APP ID' to the client ID from the GitHub application page from step 7. 1. Change 'YOUR APP SECRET' to the client secret from the GitHub application page from step 7. diff --git a/doc/public_access/public_access.md b/doc/public_access/public_access.md index 9b117319eec..4712c387021 100644 --- a/doc/public_access/public_access.md +++ b/doc/public_access/public_access.md @@ -1,6 +1,6 @@ # Public access -Gitlab allows you to open selected projects to be accessed **publicly** or **internally**. +GitLab allows you to open selected projects to be accessed **publicly** or **internally**. Projects with either of these visibility levels will be listed in the [public access directory](/public). diff --git a/doc/raketasks/backup_restore.md b/doc/raketasks/backup_restore.md index a0e38067094..8200a8cf630 100644 --- a/doc/raketasks/backup_restore.md +++ b/doc/raketasks/backup_restore.md @@ -51,7 +51,7 @@ Deleting old backups... [SKIPPING] Please be informed that a backup does not store your configuration files. If you use Omnibus-GitLab please see the [instructions in the readme to backup your configuration](https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/README.md#backup-and-restore-omnibus-gitlab-configuration). If you have a cookbook installation there should be a copy of your configuration in Chef. -If you have a manual installation please consider backing up your gitlab.yml file and any ssl keys and certificates. +If you have a manual installation please consider backing up your gitlab.yml file and any SSL keys and certificates. ## Restore a previously created backup diff --git a/doc/raketasks/maintenance.md b/doc/raketasks/maintenance.md index 9f5d21527c3..a0901cc4070 100644 --- a/doc/raketasks/maintenance.md +++ b/doc/raketasks/maintenance.md @@ -111,9 +111,9 @@ Redis version >= 2.0.0? ... yes Checking GitLab ... Finished ``` -## (Re-)Create satellite repos +## (Re-)Create satellite repositories -This will create satellite repos for all your projects. +This will create satellite repositories for all your projects. If necessary, remove the `tmp/repo_satellites` directory and rerun the command below. diff --git a/doc/release/monthly.md b/doc/release/monthly.md index b455fc7d73c..09bdde81dcc 100644 --- a/doc/release/monthly.md +++ b/doc/release/monthly.md @@ -45,7 +45,7 @@ Any changes not yet added to the changelog are added by lead developer and in th * Release CE and EE (#LINK) -23th: +23rd: * Prepare package for GitLab.com release (#LINK) @@ -73,9 +73,9 @@ The RC1 release comes with the task to update the installation and upgrade docs. 1. Create: CE update guide from previous version. Like `from-6-8-to-6.9` 1. Create: CE to EE update guide in EE repository for latest version. -1. Update: https://gitlab.com/gitlab-org/gitlab-ce/blob/master/doc/update/6.0-to-6.x.md to latest version. +1. Update: https://gitlab.com/gitlab-org/gitlab-ce/blob/master/doc/update/6.0-to-6.x.md to latest version. -It's best to copy paste the previous guide and make changes where necessary. +It's best to copy paste the previous guide and make changes where necessary. The typical steps are listed below with any points you should specifically look at. #### 0. Any major changes? diff --git a/doc/release/security.md b/doc/release/security.md index f20d7e16222..da442de6ee1 100644 --- a/doc/release/security.md +++ b/doc/release/security.md @@ -59,7 +59,7 @@ XXX ### Credit -We want to thank XXX of XXX for the reponsible disclosure of this vulnerability. +We want to thank XXX of XXX for the responsible disclosure of this vulnerability. ## Email template diff --git a/doc/update/4.2-to-5.0.md b/doc/update/4.2-to-5.0.md index 30b25a2d2d5..27cc72c1cb6 100644 --- a/doc/update/4.2-to-5.0.md +++ b/doc/update/4.2-to-5.0.md @@ -67,7 +67,7 @@ sudo rm -rf /home/gitlab/gitlab-satellites sudo rm /tmp/gitlab.socket ``` -## 5. Update gitlab to recent version +## 5. Update GitLab to recent version ```bash cd /home/git/gitlab @@ -157,7 +157,7 @@ sudo -u git -H /home/git/gitlab-shell/bin/check # /home/git/.ssh/authorized_keys: OK -# Now check gitlab instance +# Now check GitLab instance sudo -u git -H bundle exec rake gitlab:check RAILS_ENV=production ``` diff --git a/doc/update/6.2-to-6.3.md b/doc/update/6.2-to-6.3.md index dfe2e551b36..345480c4d32 100644 --- a/doc/update/6.2-to-6.3.md +++ b/doc/update/6.2-to-6.3.md @@ -32,7 +32,7 @@ sudo -u git -H git fetch sudo -u git -H git checkout v1.7.9 # Addresses multiple critical security vulnerabilities ``` -The Gitlab-shell config changed recently, so check for config file changes and make `/home/git/gitlab-shell/config.yml` the same as <https://github.com/gitlabhq/gitlab-shell/blob/master/config.yml.example> +The gitlab-shell config changed recently, so check for config file changes and make `/home/git/gitlab-shell/config.yml` the same as <https://github.com/gitlabhq/gitlab-shell/blob/master/config.yml.example> ## 4. Install libs, migrations, etc. @@ -55,7 +55,7 @@ sudo -u git -H bundle exec rake assets:clean assets:precompile cache:clear RAILS ## 5. Update config files -TIP: to see what changed in gitlab.yml.example in this release use next command: +TIP: to see what changed in gitlab.yml.example in this release use next command: ``` git diff 6-2-stable:config/gitlab.yml.example 6-3-stable:config/gitlab.yml.example diff --git a/doc/update/6.6-to-6.7.md b/doc/update/6.6-to-6.7.md index 1e3b7da12d4..c3a749b9a92 100644 --- a/doc/update/6.6-to-6.7.md +++ b/doc/update/6.6-to-6.7.md @@ -18,7 +18,7 @@ cd /home/git/gitlab sudo -u git -H git fetch --all ``` -For Gitlab Community Edition: +For GitLab Community Edition: ```bash sudo -u git -H git checkout 6-7-stable diff --git a/doc/update/6.8-to-6.9.md b/doc/update/6.8-to-6.9.md index 4a3e45ae5ee..b7305d082a5 100644 --- a/doc/update/6.8-to-6.9.md +++ b/doc/update/6.8-to-6.9.md @@ -20,7 +20,7 @@ cd /home/git/gitlab sudo -u git -H git fetch --all ``` -For Gitlab Community Edition: +For GitLab Community Edition: ```bash sudo -u git -H git checkout 6-9-stable @@ -90,7 +90,7 @@ If all items are green, then congratulations upgrade is complete! ## Things went south? Revert to previous version (6.8) ### 1. Revert the code to the previous version -Follow the [`upgrade guide from 6.7 to 6.8`](6.7-to-6.8.md), except for the database migration +Follow the [`upgrade guide from 6.7 to 6.8`](6.7-to-6.8.md), except for the database migration (The backup is already migrated to the previous version) ### 2. Restore from the backup: diff --git a/doc/update/6.9-to-7.0.md b/doc/update/6.9-to-7.0.md index 6a3dd59934b..806a714c49b 100644 --- a/doc/update/6.9-to-7.0.md +++ b/doc/update/6.9-to-7.0.md @@ -52,7 +52,7 @@ cd /home/git/gitlab sudo -u git -H git fetch --all ``` -For Gitlab Community Edition: +For GitLab Community Edition: ```bash sudo -u git -H git checkout 7-0-stable @@ -126,7 +126,7 @@ If all items are green, then congratulations upgrade is complete! ## Things went south? Revert to previous version (6.9) ### 1. Revert the code to the previous version -Follow the [`upgrade guide from 6.8 to 6.9`](6.8-to-6.9.md), except for the database migration +Follow the [`upgrade guide from 6.8 to 6.9`](6.8-to-6.9.md), except for the database migration (The backup is already migrated to the previous version) ### 2. Restore from the backup: diff --git a/doc/update/7.0-to-7.1.md b/doc/update/7.0-to-7.1.md index 6864101f8c6..ba2d9a23a36 100644 --- a/doc/update/7.0-to-7.1.md +++ b/doc/update/7.0-to-7.1.md @@ -52,7 +52,7 @@ cd /home/git/gitlab sudo -u git -H git fetch --all ``` -For Gitlab Community Edition: +For GitLab Community Edition: ```bash sudo -u git -H git checkout 7-1-stable @@ -126,7 +126,7 @@ If all items are green, then congratulations upgrade is complete! ## Things went south? Revert to previous version (7.0) ### 1. Revert the code to the previous version -Follow the [`upgrade guide from 6.9 to 7.0`](6.9-to-7.0.md), except for the database migration +Follow the [`upgrade guide from 6.9 to 7.0`](6.9-to-7.0.md), except for the database migration (The backup is already migrated to the previous version) ### 2. Restore from the backup: diff --git a/doc/workflow/groups.md b/doc/workflow/groups.md index 611f871cf77..52bf611dc5e 100644 --- a/doc/workflow/groups.md +++ b/doc/workflow/groups.md @@ -21,7 +21,7 @@ When your group has been created you are presented with the group dashboard feed You can use the 'New project' button to add a project to the new group. -## Transfering an existing project into a group +## Transferring an existing project into a group You can transfer an existing project into a group you own from the project settings page. First scroll down to the 'Dangerous settings' and click 'Show them to me'. @@ -59,7 +59,7 @@ See [the GitLab Enterprise Edition documentation](http://doc.gitlab.com/ee/integ ## Allowing only admins to create groups By default, any GitLab user can create new groups. -This ability can be disabled for individual users from the admin panel. +This ability can be disabled for individual users from the admin panel. It is also possible to configure GitLab so that new users default to not being able to create groups: ``` diff --git a/doc/workflow/project_features.md b/doc/workflow/project_features.md index 48e86ee3ef5..a523b3facbe 100644 --- a/doc/workflow/project_features.md +++ b/doc/workflow/project_features.md @@ -16,7 +16,7 @@ They integrate deeply into GitLab and are easily referenced from anywhere by usi Using a merge request, you can review and discuss code before it is merged in the branch of your code. -As with issues, it can be assigned; people, issues, etc. can be refereced; milestones attached. +As with issues, it can be assigned; people, issues, etc. can be referenced; milestones attached. We see it as an integral part of working together on code and couldn't work without it. |