[FIX] Grammar and spelling

docs/development/tech_docu/api/index.md

@@ -1,6 +1,6 @@
 # API
 
-To reduce redundancy and help speed up development we encourage developers to utilize the following packages when developing apps for Alliance Auth.
+To reduce redundancy and help speed up development, we encourage developers to utilize the following packages when developing apps for Alliance Auth.
 
 :::{toctree}
 :maxdepth: 1

docs/development/tech_docu/celery.md

@@ -2,31 +2,31 @@
 
 **Alliance Auth** uses Celery for asynchronous task management. This page aims to give developers some guidance on how to use Celery when developing apps for Alliance Auth.
 
-For a complete documentation of Celery please refer to the [official Celery documentation](http://docs.celeryproject.org/en/latest/index.html).
+For the complete documentation of Celery, please refer to the [official Celery documentation](http://docs.celeryproject.org/en/latest/index.html).
 
 ## When should I use Celery in my app?
 
-There are two main cases for using celery. Long duration of a process and recurrence of a process.
+There are two main reasons for using celery. Long duration of a process, and recurrence of a process.
 
 ### Duration
 
-Alliance Auth is an online web application and as such the user expects fast and immediate responses to any of his clicks or actions. Same as with any other good web site. Good response times are measures in ms and a user will perceive everything that takes longer than 1 sec as an interruption of his flow of thought (see also [Response Times: The 3 Important Limits](https://www.nngroup.com/articles/response-times-3-important-limits/)).
+Alliance Auth is an online web application, and as such, the user expects fast and immediate responses to any of his clicks or actions. Same as with any other good website. Good response times are measured in ms, and a user will perceive everything that takes longer than 1 sec as an interruption of his flow of thought (see also [Response Times: The 3 Important Limits](https://www.nngroup.com/articles/response-times-3-important-limits/)).
 
-As a rule of thumb we therefore recommend to use celery tasks for every process that can take longer than 1 sec to complete (also think about how long your process might take with large amounts of data).
+As a rule of thumb, we therefore recommend using celery tasks for every process that can take longer than 1 sec to complete (also think about how long your process might take with large amounts of data).
 
 :::{note}
-Another solution for dealing with long response time in particular when loading pages is to load parts of a page asynchronously, for example with AJAX.
+Another solution for dealing with long response time in particular when loading pages is to load parts of a page asynchronously, for example, with AJAX.
 :::
 
 ### Recurrence
 
-Another case for using celery tasks is when you need recurring execution of tasks. For example you may want to update the list of characters in a corporation from ESI every hour.
+Another case for using celery tasks is when you need recurring execution of tasks. For example, you may want to update the list of characters in a corporation from ESI every hour.
 
-These are called periodic tasks and Alliance Auth uses [celery beat](https://docs.celeryproject.org/en/latest/userguide/periodic-tasks.html) to implement them.
+These are called periodic tasks, and Alliance Auth uses [celery beat](https://docs.celeryproject.org/en/latest/userguide/periodic-tasks.html) to implement them.
 
 ## What is a celery task?
 
-For the most part a celery task is a Python functions that is configured to be executed asynchronously and controlled by Celery. Celery tasks can be automatically retried, executed periodically, executed in work flows and much more. See the [celery docs](https://docs.celeryproject.org/en/latest/userguide/tasks.html) for a more detailed description.
+For the most part, a celery task is a Python function configured to be executed asynchronously and controlled by Celery. Celery tasks can be automatically retried, executed periodically, executed in work flows and much more. See the [celery docs](https://docs.celeryproject.org/en/latest/userguide/tasks.html) for a more detailed description.
 
 ## How should I use Celery in my app?
 
@@ -61,21 +61,21 @@ example.delay()
 
 ## How should I use celery tasks in the UI?
 
-There is a well established pattern for integrating asynchronous processes in the UI, for example when the user asks your app to perform a longer running action:
+There is a well-established pattern for integrating asynchronous processes in the UI, for example, when the user asks your app to perform a longer running action:
 
 1. Notify the user immediately (with a Django message) that the process for completing the action has been started and that he will receive a report once completed.
 
 2. Start the celery task
 
-3. Once the celery task is completed it should send a notification containing the result of the action to the user. It's important to send that notification also in case of errors.
+3. Once the celery task is completed, it should send a notification containing the result of the action to the user. It's important to send that notification also in case of errors.
 
-## Can I use long running tasks?
+## Can I use long-running tasks?
 
-Long running tasks are possible, but in general Celery works best with short running tasks. Therefore we strongly recommend to try and break down long running tasks into smaller tasks if possible.
+Long-running tasks are possible, but in general Celery works best with short running tasks. Therefore, we strongly recommend trying to break down long-running tasks into smaller tasks if possible.
 
-If contextually possible try to break down your long running task in shorter tasks that can run in parallel.
+If contextually possible, try to break down your long-running task in shorter tasks that can run in parallel.
 
-However, many long running tasks consist of several smaller processes that need to run one after the other. For example you may have a loop where you perform the same action on hundreds of objects. In those cases you can define each of the smaller processes as it's own task and then link them together, so that they are run one after the other. That is called chaining in Celery and is the preferred approach for implementing long running processes.
+However, many long-running tasks consist of several smaller processes that need to run one after the other. For example, you may have a loop where you perform the same action on hundreds of objects. In those cases, you can define each of the smaller processes as its own task and then link them together, so that they are run one after the other. That is called chaining in Celery and is the preferred approach for implementing long-running processes.
 
 Example implementation for a celery chain:
 
@@ -101,7 +101,7 @@ def long_runner():
     chain(my_tasks).delay()
 ```
 
-In this example we fist add 10 example tasks that need to run one after the other to a list. This can be done by creating a so called signature for a task. Those signature are a kind of wrapper for tasks and can be used in various ways to compose work flow for tasks.
+In this example, we first add 10 example tasks that need to run one after the other to a list. This can be done by creating a so-called signature for a task. Those signatures are a kind of wrapper for tasks and can be used in various ways to compose work flow for tasks.
 
 The list of task signatures is then converted to a chain and started asynchronously.
 
@@ -110,12 +110,12 @@ In our example we use ``si()``, which is a shortcut for "immutable signatures" a
 
 For more information on signature and work flows see the official documentation on `Canvas <https://docs.celeryproject.org/en/latest/userguide/canvas.html>`_.
 
-In this context please note that Alliance Auth currently only supports chaining, because all other variants require a so called results back, which Alliance Auth does not have.
+In this context, please note that Alliance Auth currently only supports chaining because all other variants require a so-called results back, which Alliance Auth does not have.
 :::
 
 ## How can I define periodic tasks for my app?
 
-Periodic tasks are normal celery tasks which are added the scheduler for periodic execution. The convention for defining periodic tasks for an app is to define them in the local settings. So user will need to add those settings manually to his local settings during the installation process.
+Periodic tasks are normal celery tasks that are added to the scheduler for periodic execution. The convention for defining periodic tasks for an app is to define them in the local settings. So user will need to add those settings manually to his local settings during the installation process.
 
 Example setting:
 
@@ -126,14 +126,14 @@ CELERYBEAT_SCHEDULE['structures_update_all_structures'] = {
 }
 ```
 
-- `structures_update_all_structures` is the name of the scheduling entry. You can chose any name, but the convention is name of your app plus name of the task.
+- `structures_update_all_structures` is the name of the scheduling entry. You can choose any name, but the convention is name of your app plus name of the task.
 
 - `'task'`: Name of your task (full path)
 - `'schedule'`: Schedule definition (see Celery documentation on [Periodic Tasks](https://docs.celeryproject.org/en/latest/userguide/periodic-tasks.html) for details)
 
 ## How can I use priorities for tasks?
 
-In Alliance Auth we have defined task priorities from 0 - 9 as follows:
+In Alliance Auth we have defined task priorities from 0 to 9 as follows:
 
 ```{eval-rst}
     ====== ========= ===========
@@ -151,12 +151,12 @@ In Alliance Auth we have defined task priorities from 0 - 9 as follows:
 :::{warning}
 Please make sure to use task priorities with care and especially do not use higher priorities without a good reason. All apps including Alliance Auth share the same task queues, so using higher task priorities excessively can potentially prevent more important tasks (of other apps) from completing on time.
 
-You also want to make sure to run use lower priorities if you have a large amount of tasks or long running tasks, which are not super urgent. (e.g. the regular update of all Eve characters from ESI runs with priority 7)
+You also want to make sure to run use lower priorities if you have a large number of tasks or long-running tasks, which are not super urgent. (e.g., the regular update of all Eve characters from ESI runs with priority 7)
 :::
 :::{hint}
-If no priority is specified all tasks will be started with the default priority, which is 5.
+If no priority is specified, all tasks will be started with the default priority, which is 5.
 :::
-To run a task with a different priority you need to specify it when starting it.
+To run a task with a different priority, you need to specify it when starting it.
 
 Example for starting a task with priority 3:
 
@@ -165,7 +165,7 @@ example.apply_async(priority=3)
 ```
 
 :::{hint}
-For defining a priority to tasks you can not use the convenient shortcut ``delay()``, but instead need to start a task with ``apply_async()``, which also requires you to pass parameters to your task function differently. Please check out the `official docs <https://docs.celeryproject.org/en/stable/reference/celery.app.task.html#celery.app.task.Task.apply_async>`_ for details.
+For defining a priority to tasks, you cannot use the convenient shortcut ``delay()``, but instead need to start a task with ``apply_async()``, which also requires you to pass parameters to your task function differently. Please check out the `official docs <https://docs.celeryproject.org/en/stable/reference/celery.app.task.html#celery.app.task.Task.apply_async>`_ for details.
 :::
 
 ## What special features should I be aware of?
@@ -174,7 +174,7 @@ Every Alliance Auth installation will come with a couple of special celery relat
 
 ### celery-once
 
-Celery-once is a celery extension "that allows you to prevent multiple execution and queuing of celery tasks". What that means is that you can ensure that only one instance of a celery task runs at any given time. This can be useful for example if you do not want multiple instances of you task to talk to the same external service at the same time.
+Celery-once is a celery extension "that allows you to prevent multiple execution and queuing of celery tasks". What that means is that you can ensure that only one instance of a celery task runs at any given time. This can be useful, for example, if you do not want multiple instances of your task to talk to the same external service at the same time.
 
 We use a custom backend for celery_once in Alliance Auth defined [here](https://gitlab.com/allianceauth/allianceauth/-/blob/master/allianceauth/services/tasks.py#L14)
 You can import it for use like so:
@@ -183,7 +183,7 @@ You can import it for use like so:
 from allianceauth.services.tasks import QueueOnce
 ```
 
-An example of AllianceAuth's use within the `@sharedtask` decorator, can be seen [here](https://gitlab.com/allianceauth/allianceauth/-/blob/master/allianceauth/services/modules/discord/tasks.py#L62) in the discord module
+An example of Alliance Auth's use within the `@sharedtask` decorator, can be seen [here](https://gitlab.com/allianceauth/allianceauth/-/blob/master/allianceauth/services/modules/discord/tasks.py#L62) in the discord module
 You can use it like so:
 
 ```python
@@ -194,4 +194,4 @@ Please see the [official documentation](https://pypi.org/project/celery_once/) o
 
 ### task priorities
 
-Alliance Auth is using task priorities to enable priority based scheduling of task execution. Please see [How can I use priorities for tasks?](#how-can-i-use-priorities-for-tasks) for details.
+Alliance Auth is using task priorities to enable priority-based scheduling of task execution. Please see [How can I use priorities for tasks?](#how-can-i-use-priorities-for-tasks) for details.

docs/development/tech_docu/index.md

@@ -1,6 +1,6 @@
 # Developing apps
 
-In this section you find topics useful for app developers.
+In this section, you find topics useful for app developers.
 
 :::{toctree}
 :maxdepth: 1