mirror of
https://gitlab.com/allianceauth/allianceauth.git
synced 2025-12-18 23:05:07 +01:00
[FIX] Grammar and spelling
This commit is contained in:
@@ -2,7 +2,7 @@
|
||||
|
||||
## Pre-Commit
|
||||
|
||||
Alliance Auth is a team effort with developers of various skill levels and background. To avoid significant drift or formatting changes between developers we use [pre-commit](https://pre-commit.com/) to apply a very minimal set of formatting checks to code contributed to the project.
|
||||
Alliance Auth is a team effort with developers of various skill levels and background. To avoid significant drift or formatting changes between developers, we use [pre-commit](https://pre-commit.com/) to apply a very minimal set of formatting checks to code contributed to the project.
|
||||
|
||||
Pre-commit is also very popular with our Community Apps and may be significantly more opinionated or looser depending on the project.
|
||||
|
||||
@@ -46,4 +46,4 @@ These can be used to automatically generate our Sphinx documentation in either f
|
||||
|
||||
It is advisable to avoid wide formatting changes on code that is not being modified by an MR. Further to this, automated code formatting should be kept to a minimal when modifying sections of existing files.
|
||||
|
||||
If you are contributing whole modules or rewriting large sections of code you may use any legible code formatting valid under Python.
|
||||
If you are contributing whole modules or rewriting large sections of code, you may use any legible code formatting valid under Python.
|
||||
|
||||
@@ -11,8 +11,8 @@ allows for documentation to be maintained at different versions more easily.
|
||||
|
||||
## Building Documentation
|
||||
|
||||
If you're developing new documentation, its likely you'll want or need to test build it before committing to your
|
||||
branch. To achieve this you can use Sphinx to build the documentation locally as it appears on Read the Docs.
|
||||
If you're developing new documentation, it's likely you'll want or need to test build it before committing to your
|
||||
branch. To achieve this, you can use Sphinx to build the documentation locally as it appears on Read the Docs.
|
||||
|
||||
Activate your virtual environment (if you're using one) and install the documentation requirements found in
|
||||
`docs/requirements.txt` using pip, e.g. `pip install -r docs/requirements.txt`.
|
||||
@@ -35,5 +35,5 @@ reStructuredText here
|
||||
```
|
||||
````
|
||||
|
||||
Markdown is used elsewhere on Github so it provides the most portability of documentation from Issues and Pull Requests
|
||||
as well as providing an easier initial migration path from the Github wiki.
|
||||
Markdown is used elsewhere on GitHub, so it provides the most portability of documentation from Issues and Pull Requests
|
||||
as well as providing an easier initial migration path from the GitHub wiki.
|
||||
|
||||
Reference in New Issue
Block a user