Fixed lots of typos, thanks Claude

Author: mdipierro

docs/chapter-01.rst

@@ -94,7 +94,7 @@ details if you come from web2py):
 -  PY4WEB leverages PyDAL's new tags functionality
    to tag users with groups, search users by groups, and
    apply permissions based on membership.
--  PY4WEB comes with with some custom Vue.js components designed to
+-  PY4WEB comes with some custom Vue.js components designed to
    interact with the PyDAL RESTAPI, and with PY4WEB in general. These
    APIs are designed to allow the server to set policies about which
    operations a client is allowed to perform, but give the client

docs/chapter-02.rst

@@ -2,7 +2,7 @@
 Help, resources and hints
 =========================
 
-We've made our best to make PY4WEB simple and clean. But you know, modern web programming is a daunting task. It requires an open mind, able to
+We've done our best to make PY4WEB simple and clean. But you know, modern web programming is a daunting task. It requires an open mind, able to
 jump frequently (without being lost!) from python to HTML to javascript to css and even database management. 
 But don't be scared, in this manual we'll assist you side by side in this journey. And there are many other valuable resources that we're going to show
 you.
@@ -15,7 +15,7 @@ This manual
 -----------
 
 This manual is the Reference Manual for py4web. It's available online at https://py4web.com/_documentation/static/index.html, where you'll also find the 
-PDF and EBOOK version, in multiple languages. It written in RestructuredText and generated using Sphinx.
+PDF and EBOOK version, in multiple languages. It is written in RestructuredText and generated using Sphinx.
 
 
 The Google group
@@ -45,7 +45,7 @@ There are many tutorials and videos available. Here are some of them:
 - the `South Breeze Enterprises demo app <https://github.com/jpsteil/southbreeze>`__ by `Jim Steil <https://github.com/jpsteil>`__.  It is built around
   the structure of the Microsoft Northwind database,
   but converted to SQLite. You can view the final result online `here <https://southbreeze.pythonbench.com>`__
-- the `py4web blog in spanish <https://py4web-tutoriales.blogspot.com>`__ by Alan Etkin, wich covers the basics to start with the framework plus examples. It is thought as a resource for sudents and aims to provide a full web development course
+- the `py4web blog in spanish <https://py4web-tutoriales.blogspot.com>`__ by Alan Etkin, which covers the basics to start with the framework plus examples. It is intended as a resource for students and aims to provide a full web development course
 
 The sources on GitHub
 ---------------------
@@ -83,7 +83,7 @@ we also suggest to:
   introduction). In a complex workplace this will avoid to be messed up
   with other python programs and modules
 - use **git** to keep track of your program's changes and save
-  your changes in a safe place online (GitHub, GitLat, or Bitbucket).
+  your changes in a safe place online (GitHub, GitLab, or Bitbucket).
 - use an editor with Syntax Highlighting. We highly recommend
   Visual Studio Code (VScode) or PyCharm.
 
@@ -132,7 +132,7 @@ In PyCharm, if you should get gevent errors you need to enable Settings | Build,
 How to contribute
 =================
 
-We need help from everyone: support our efforts! You can just participate in the Google group trying to answer other's questions, submit bugs using or
+We need help from everyone: support our efforts! You can just participate in the Google group trying to answer others' questions, submit bugs or
 create pull requests on the GitHub repository.
 
 If you wish to correct and expand this manual, or even translate it in a new foreign language, you can read all the needed information directly on

docs/chapter-03.rst

@@ -6,7 +6,7 @@ Understanding the design
 ------------------------
 
 Before everything else it is important to understand that unlike other web frameworks,
-is not only a python module that can be imported by apps. It is also a program that
+py4web is not only a python module that can be imported by apps. It is also a program that
 is in charge of starting some apps. For this reason you need two things:
 
 -  The py4web module (which you download from our web site, from pypi or from github)
@@ -142,7 +142,7 @@ Also notice that when installing in this way the content of
 ``py4web/assets`` folder is missing at first but it is manually created
 later with the ``make assets`` command.
 
-Notice that you also (and should) install py4web from source inside a virtual environment.
+Notice that you can also (and should) install py4web from source inside a virtual environment.
 
 Running from source without installing
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -215,14 +215,14 @@ Unzip it on a local folder and open a command line there. Finally run
 
 (omit './' if you're using Windows).
 
-Notice: the binaries many not correspond to the latest master
+Notice: the binaries may not correspond to the latest master
 or the latest stable branch of py4web although we do our best to
 keep them up to date.      
 
 Upgrading
 ---------
 
-If you installed py4web from pip you can simple upgrade it with
+If you installed py4web from pip you can simply upgrade it with
 
 ::
 
@@ -271,7 +271,7 @@ output like this:
    :class: with-shadow
 
 Generally ``apps`` is the name of the folder where you keep all your
-apps, and can be explicitly set wit the ``run`` command.
+apps, and can be explicitly set with the ``run`` command.
 (Yet nothing prevents you from grouping apps in multiple folders with
 different names.) If that
 folder does not exist, it is created. PY4WEB expects to find at least
@@ -437,7 +437,7 @@ By default py4web will automatically reload an application upon any changes to t
 The reloading will occur on any first incoming request to the application that has
 been changed (lazy-mode). If you prefer an immediate reloading (sync-mode), use
 ``py4web run --watch sync``. For production servers, it's better to use ``py4web run --watch off`` in order
-to avoid unneded checks (but you will need to restart py4web for activating any change).
+to avoid unneeded checks (but you will need to restart py4web for activating any change).
 
 
 .. note::
@@ -523,7 +523,7 @@ Finally you can manually create the file yourself with:
      -Y, --yes          No prompt, assume yes to questions  [default: False]
      -help, -h, --help  Show this message and exit.
 
-This option create a new apps folder (or reinstall it). If needed, it
+This option creates a new apps folder (or reinstall it). If needed, it
 will ask for the confirmation of the new folder’s creation and then for
 copying every standard py4web apps from the assets folder. It currently
 does nothing on binaries installations and from source installation
@@ -592,7 +592,7 @@ HTTPS
 
 To use https with the build-in web server (Rocket3) these are the steps:
 
-- Generate the localhost certificates. For example followed the instructions here:
+- Generate the localhost certificates. For example follow the instructions here:
 
    https://www.section.io/engineering-education/how-to-get-ssl-https-for-localhost/.
 
@@ -625,7 +625,7 @@ Notice that /path_to/ should be the absolute path to the location of your certif
 WSGI
 ~~~~
 
-py4web is a standard WSGI application. So, if a full program installation it's not
+py4web is a standard WSGI application. So, if a full program installation is not
 feasible you can simply run py4web as a WSGI app. For example, using gunicorn-cli,
 create a python file:
 
@@ -719,7 +719,7 @@ On ``deployment_tools/docker`` there is a simple Dockerfile for quickly running
 a docker-compose.yml file for setting up a more complex multi-container with PostgreSQL. 
 A ready docker example based on the Scaffold application can be cloned from this repository <https://github.com/macneiln/docker-py4web-scaffold>
 
-Note that you can use them also with Podman, which has the advantage of does not requiring sudo and does not
+Note that you can use them also with Podman, which has the advantage of not requiring sudo and does not
 running any background daemon.
 
 

docs/chapter-05.rst

@@ -206,7 +206,7 @@ in errors:
    def color(name):
        return f'Color name: {name}'
 
-Instead, to accomplish a simmilar result, one needs to handle all the 
+Instead, to accomplish a similar result, one needs to handle all the 
 logic in one action:
 
 .. code:: python
@@ -438,14 +438,14 @@ Watch for files change
 ----------------------
 
 As described in the :ref:`run command option`, Py4web facilitates a
-development server’s setup by automatically reloads an app when its
+development server’s setup by automatically reloading an app when its
 Python source files change (by default).
 But in fact any other files inside an app can be watched by setting a
 handler function using the ``@app_watch_handler`` decorator.
 
 Two examples of this usage are reported now. Do not worry if you don’t
 fully understand them: the key point here is that even non-python code
-could be reloaded automatically if you explicit it with the
+could be reloaded automatically if you explicitly declare it with the
 ``@app_watch_handler`` decorator.
 
 Watch SASS files and compile them when edited:
@@ -496,7 +496,7 @@ In production environments it is often required to have several apps being
 served by a single py4web server, where different apps are mapped to
 different domains. 
 
-py4web can easily handle running multiple apps, but there is no build-in
+py4web can easily handle running multiple apps, but there is no built-in
 mechanism for mapping domains to specific applications. Such mapping needs
 to be done externally to py4web -- for instance using a web reverse-proxy, 
 such as nginx. 

docs/chapter-06.rst

@@ -62,7 +62,7 @@ Then you can apply all of them at once with:
 
 Usually, it's not important the order you use to specify the fixtures, because py4web
 knows well how to manage them if they have explicit dependencies. For example auth
-depends explicitly on db and session and flash, so you do not even needs to list them.
+depends explicitly on db and session and flash, so you do not even need to list them.
 
 But there is an important exception: the Template fixture must always be the
 **first one**. Otherwise, it will not have access to various things it should
@@ -281,7 +281,7 @@ Now try create a file called ``translations/it.json`` which contains:
 Set your browser preference to Italian: now the messages will be
 automatically translated to Italian.
 
-Notice there is an UI in the Dashboard for creating, updating, and updating translation files. 
+Notice there is a UI in the Dashboard for creating, updating, and managing translation files. 
 It can be easily reached via the button ``i18n+p11n``:
 
 .. image:: images/dashboard_i18n_btn.png
@@ -404,8 +404,8 @@ Opening the page in a new browser tab will give you the updated
 counter value. Closing and reopening the browser, or opening a
 new *private window*, will instead restart the counter from 0.
 
-Usually the information is saved in the session object are related
-to the user - like its username, preferences, last pages visited,
+Usually the information saved in the session object is related
+to the user - like their username, preferences, last pages visited,
 shopping cart and so on. The session object has the same interface
 as a Python dictionary but in py4web sessions are always stored using
 JSON (**JWT** specifically, i.e. 
@@ -431,7 +431,7 @@ set. Other parameters can be specified as well:
                      algorithm='HS256',
                      storage=None,
                      same_site='Lax',
-                     name="{app_name}_sesson")
+                     name="{app_name}_session")
 
 Here:
 
@@ -870,16 +870,16 @@ Under normal circumstances above methods are executed in this order:
 
 i.e. the first fixture (A) is the first one to call ``on_request``
 and the last one to call ``on_success``. You can think of them as layers of
-an onion with the action (user code) at the center. ``on_success`` is called
+an onion with the action (user code) at the center. ``on_request`` is called
 when entering a layer from the outside and ``on_success`` is called when
 exiting a layer from the inside (like WSGI middleware).
 
-If any point an exception is raised inner layers are not called
+If at any point an exception is raised inner layers are not called
 and outer layers will call ``on_error`` instead of ``on_success``.
 
 Context is a shared object which contains:
 
-- content['fixtures']: the list of all the fixtures for the action.
+- context['fixtures']: the list of all the fixtures for the action.
 - context['processed']: the list of fixtures that called ``on_request`` previously within the request.
 - context['exception']: the exception raised by the action or any previous fixture logic (usually None)
 - context['output']: the action output.
@@ -1031,7 +1031,7 @@ Notably, the initializer should contain the line:
 
 in order to initialize the thread-local storage.
 Once this is done, the thread-local storage can be used to store and retrieve data
-using the the ``self.local`` object. 
+using the ``self.local`` object. 
 
 
 Multiple fixtures

docs/chapter-08.rst

@@ -1073,7 +1073,7 @@ OUTPUT:
 The RestAPI response
 --------------------
 
-All RestAPI response have the fields:
+All RestAPI responses have the fields:
 
 :api_version: RestAPI version.
 :timestamp: Datetime in ISO 8601 format.

docs/chapter-10.rst

@@ -161,7 +161,7 @@ Built-in helpers
 ``XML``
 ~~~~~~~
 
-``XML`` is an helper object used to encapsulate text that should **not** be
+``XML`` is a helper object used to encapsulate text that should **not** be
 escaped. The text may or may not contain valid XML; for example it
 could contain JavaScript.
 
@@ -442,7 +442,7 @@ The ``CODE`` helper is generally preferable for code listings.
 ``SCRIPT``
 ~~~~~~~~~~
 
-This is for include or link a script, such as JavaScript.
+This is for including or linking a script, such as JavaScript.
 
 .. code:: python
 
@@ -609,7 +609,7 @@ Custom helpers
 ``TAG``
 ~~~~~~~
 
-Sometimes you need to generate **custom XML tags***. For this purpose py4web
+Sometimes you need to generate **custom XML tags**. For this purpose py4web
 provides ``TAG``, a universal tag generator.
 
 ::

docs/chapter-11.rst

@@ -36,7 +36,7 @@ Here is another example for the word “bed” in Czech
 
    {"bed": {"0": "no postel", "1": "postel", "2": "postele", "5": "postelí"}}
 
-To translate and pluralize a string “dog” one simply warps the string in
+To translate and pluralize a string “dog” one simply wraps the string in
 the T operator as follows:
 
 ::

docs/chapter-12.rst

@@ -128,7 +128,7 @@ Create a new minimal app called ``form_minimal`` :
 .. code:: python
 
     # in controllers.py
-    from py4web impot action, redirect, URL, Field
+    from py4web import action, redirect, URL, Field
     from py4web.utils.form import Form
     from pydal.validators import *
 
@@ -429,7 +429,7 @@ must be preceded by an underscore.
 Custom forms
 ~~~~~~~~~~~~
 
-Custom forms allow you to granulary control how the form is processed. In the template file, you can execute specific
+Custom forms allow you to granularly control how the form is processed. In the template file, you can execute specific
 instructions before the form is displayed or after its data submission by inserting code among the following statements:
 
 .. code:: html