Doc Terminology updates (#13972)

* Doc Terminology updates

* API updates

(cherry picked from commit 52f3775)

Author: Felonious-Spellfire

docs/source-app/core_api/lightning_app/index.rst

@@ -24,20 +24,12 @@ Peek under the hood
    :tag: Basic
 
 .. displayitem::
-   :header: The App state (basic)
-   :description: Learn more about the state and its manipulation.
-   :col_css: col-md-4
-   :button_link: ../../workflows/access_app_state.html
-   :height: 180
-   :tag: basic
-
-.. displayitem::
-   :header: The event loop (basic)
+   :header: The event loop (Basic)
    :description: Learn more about the event loop.
    :col_css: col-md-4
    :button_link: ../../glossary/event_loop.html
    :height: 180
-   :tag: basic
+   :tag: Basic
 
 .. displayitem::
    :header: Communication between Flow and Works

docs/source-app/examples/dag/dag.rst

@@ -1,6 +1,6 @@
-####################################
-Build a Directed Acyclic Graph (DAG)
-####################################
+######################################
+Develop a Directed Acyclic Graph (DAG)
+######################################
 
 .. _dag_example:
 

docs/source-app/examples/hpo/hpo.rst

@@ -2,9 +2,9 @@
 .. _hpo_example:
 
 
-#######################################################
-Build a Lightning Hyperparameter Optimization (HPO) App
-#######################################################
+#########################################################
+Develop a Lightning Hyperparameter Optimization (HPO) App
+#########################################################
 
 *******************
 A bit of background

docs/source-app/examples/model_server_app/model_server.rst

@@ -1,8 +1,8 @@
 :orphan:
 
-***********************************
-2. Build the Model Server Component
-***********************************
+*************************************
+2. Develop the Model Server Component
+*************************************
 
 In the code below, we use `MLServer <https://github.com/SeldonIO/MLServer>`_ which aims to provide an easy way to start serving your machine learning models through a REST and gRPC interface,
 fully compliant with KFServing's V2 Dataplane spec.
@@ -19,15 +19,15 @@ fully compliant with KFServing's V2 Dataplane spec.
 .. Add callout items below this line
 
 .. displayitem::
-   :header: 1.  Build a Train Component
+   :header: 1.  Develop a Train Component
    :description: Train a model and store its checkpoints with SKlearn
    :col_css: col-md-4
    :button_link: train.html
    :height: 150
    :tag: Intermediate
 
 .. displayitem::
-   :header: 3. Build a Load Testing Component
+   :header: 3. Develop a Load Testing Component
    :description: Use Locust to test your model servers
    :col_css: col-md-4
    :button_link: load_testing.html
@@ -36,7 +36,7 @@ fully compliant with KFServing's V2 Dataplane spec.
 
 .. displayitem::
    :header: 4. Putting everything together.
-   :description: Ensemble the components together and run the app
+   :description: Ensemble the Components together and run the App
    :col_css: col-md-4
    :button_link: putting_everything_together.html
    :height: 150

docs/source-app/examples/model_server_app/model_server_app.rst

@@ -2,9 +2,9 @@
 
 .. _model_server_example:
 
-####################
-Build a Model Server
-####################
+######################
+Develop a Model Server
+######################
 
 **Audience:** Users who want to serve their trained models.
 

docs/source-app/examples/model_server_app/putting_everything_together.rst

@@ -43,31 +43,31 @@ Find more examples
 .. Add callout items below this line
 
 .. displayitem::
-   :header: Build a DAG
-   :description: Create a dag pipeline
+   :header: Develop a DAG
+   :description: Develop a DAG pipeline
    :col_css: col-md-4
    :button_link: ../dag/dag.html
    :height: 150
    :tag: Intermediate
 
 .. displayitem::
-   :header: Build a File Server
+   :header: Develop a File Server
    :description: Train multiple models with different parameters
    :col_css: col-md-4
    :button_link: ../file_server/file_server.html
    :height: 150
    :tag: Intermediate
 
 .. displayitem::
-   :header: Build a Github Repo Script Runner
+   :header: Develop a Github Repo Script Runner
    :description: Run code from the internet in the cloud
    :col_css: col-md-4
    :button_link: ../github_repo_runner/github_repo_runner.html
    :height: 150
    :tag: Intermediate
 
 .. displayitem::
-   :header: Build a HPO Sweeper
+   :header: Develop a HPO Sweeper
    :description: Train multiple models with different parameters
    :col_css: col-md-4
    :button_link: ../hpo/hpo.html

docs/source-app/index.rst

@@ -221,13 +221,13 @@ Keep Learning
 
 .. toctree::
    :maxdepth: 1
-   :caption: Practical Examples
+   :caption: Examples
 
-   Build a DAG <examples/dag/dag>
-   Build a File Server <examples/file_server/file_server>
-   Build a Github Repo Script Runner <examples/github_repo_runner/github_repo_runner>
-   Build a HPO Sweeper <examples/hpo/hpo>
-   Build a Model Server <examples/model_server_app/model_server_app>
+   Develop a DAG <examples/dag/dag>
+   Develop a File Server <examples/file_server/file_server>
+   Develop a Github Repo Script Runner <examples/github_repo_runner/github_repo_runner>
+   Develop a HPO Sweeper <examples/hpo/hpo>
+   Develop a Model Server <examples/model_server_app/model_server_app>
 
 ..
    [Docs under construction] Build a data exploring app  <examples/data_explore_app>
@@ -237,19 +237,19 @@ Keep Learning
 
 .. toctree::
    :maxdepth: 1
-   :caption: Common Workflows
+   :caption: How to...
 
    Add a web user interface (UI) <workflows/add_web_ui/index>
    Add a web link  <workflows/add_web_link>
    Arrange app tabs <workflows/arrange_tabs/index>
-   Build a Lightning app <workflows/build_lightning_app/index>
-   Build a Lightning component <workflows/build_lightning_component/index>
+   Develop a Lightning App <workflows/build_lightning_app/index>
+   Develop a Lightning Component <workflows/build_lightning_component/index>
    Cache Work run calls  <workflows/run_work_once>
    Customize your cloud compute <core_api/lightning_work/compute>
    Extend an existing app <workflows/extend_app>
    Publish a Lightning component <workflows/build_lightning_component/publish_a_component>
    Run a server within a Lightning App <workflows/add_server/index>
-   Run an app on the cloud <workflows/run_app_on_cloud/index>
+   Run an App on the cloud <workflows/run_app_on_cloud/index>
    Run work in parallel <workflows/run_work_in_parallel>
    Share an app  <workflows/share_app>
    Share files between components <workflows/share_files_between_components>

docs/source-app/workflows/build_lightning_app/from_pytorch_lightning_script.rst

@@ -1,27 +1,28 @@
-#######################################
-Build app from PyTorch Lightning script
-#######################################
+#######################################################
+Develop a Lightning App from a PyTorch Lightning script
+#######################################################
 
-**Audience:** Users who want to build an app from their PyTorch Lightning scripts.
+**Audience:** Users who want to develop a Lightning App (App) from their PyTorch Lightning (PL) scripts.
 
 ----
 
-***********************************************
-Why do I want to build an app from a PL script?
-***********************************************
-Generating an app from a PL script allows you to immediately run on the cloud and share the progress with friends.
+*************************************************************
+What developing a Lightning App from a PL script does for you
+*************************************************************
+
+Developing an App from a PL script allows you to immediately run on the cloud and share the progress with friends.
 Once you're happy with your model, you can immediately expand beyond just model development to things like
-making your own inference APIs, research demos or even speeding up your data pipeline.
+making your own inference APIs, research demos, or even speeding up your data pipeline.
 
-The PyTorch Lightning app is your entry point to the full end-to-end ML licefycle.
+The PyTorch Lightning App is your entry point to the full end-to-end ML licefycle.
 
 ----
 
-*******************
-Generate a template
-*******************
+******************
+Develop a template
+******************
 
-To generate a template from a PyTorch Lightning script, use this command:
+To develop a template from a PyTorch Lightning script, use this command:
 
 .. code:: bash
 
@@ -35,22 +36,23 @@ If your script is not at the root of the project folder, and you'd like to inclu
     lightning init pl-app path/to/project/root path/to/the/pl_script.py
 
 
-The default trainer app lets you train a model with a beautiful UI locally and on the cloud with zero effort!
+The default trainer App lets you train a model with a beautiful UI locally and on the cloud with zero effort!
 
 ----
 
 ***********
-Run the app
+Run the App
 ***********
-.. note:: this page is under construction
 
-Run the app locally:
+.. note:: This section is under construction.
+
+Run the App locally:
 
 .. code:: bash
 
     lightning run app pl-app/app.py
 
-Or run it on the cloud so you can share with collaborators and even use all the cloud GPUs you want
+Or run the App on the cloud so you can share with collaborators and even use all the cloud GPUs you want.
 
 .. code:: bash
 
@@ -67,7 +69,7 @@ Or run it on the cloud so you can share with collaborators and even use all the
 Modify the template
 *******************
 
-The command above generates an app file like this:
+The command above generates an App file like this:
 
 .. note:: TODO: list the file and show how to extend it
 
@@ -99,7 +101,7 @@ Now you can add your own components as you wish!
 Known issues
 ************
 
-- The UI takes a couple seconds to load when opening the app, be patient.
+- The UI takes a couple seconds to load when opening the App, so please be patient.
 - The timer resets when refreshing the page.
 - The UI for adding new environment variables does not provide an option to delete an entry.
 - A bug exists that leaves the script hanging at the start of training when using the DDP strategy.

docs/source-app/workflows/build_lightning_app/from_scratch.rst

@@ -1,7 +1,8 @@
-##################################
-Build a Lightning App from Scratch
-##################################
-**Audience:** Users who want to build a Lightning App from scratch.
+####################################
+Develop a Lightning App from Scratch
+####################################
+
+**Audience:** Users who want to develop a Lightning App from scratch.
 
 **Prereqs:** You must have finished the `Basic levels <https://lightning.ai/lightning-docs/levels/basic/>`_.
 

docs/source-app/workflows/build_lightning_app/index.rst

@@ -1,7 +1,8 @@
-#####################
-Build a Lightning app
-#####################
-A Lightning app is a collection of components interacting together. Learn how to generate a basic app template.
+#######################
+Develop a Lightning App
+#######################
+
+A Lightning App (App) is a collection of components interacting together. Learn how to develop a basic App template.
 
 ----