Add fixes

Signed-off-by: Ayan Sinha Mahapatra <ayansmahapatra@gmail.com>

Author: AyanSinhaMahapatra

docs/source/cli-reference/synopsis.rst

@@ -19,8 +19,8 @@ Installation
 ------------
 
 Scancode-Toolkit installation can be done by downloading ScanCode as an application, which
-is recommended generally. For users familiar with ``pip``, ScanCode is also available and can be
-installed from ``pip``, the default Python Package Manager. Refer the following sections for
+is recommended generally. For users who wish to use ScanCode as a library, it can be
+installed via ``pip``, the default Python Package Manager. Refer the following sections for
 detailed Instructions on the each of the Installation Methods.
 
 - :ref:`app_install`

docs/source/getting-started/install.rst

@@ -5,21 +5,20 @@ There are 3 main ways you can install ScanCode.
 
 - :ref:`app_install`
 
-    The recommended method for installing ScanCode is Downloading the latest release, as an
+    The recommended method for installing ScanCode is Downloading the latest release as an
     application and then configure and use directly. This is easy because no knowledge of pip/git
     or other developer tools is necessary.
 
-- :ref:`pip_install`
-
-    The fastest way to install ScanCode as a python package, using ``pip``. You can also install
-    ScanCode by compiling it from source or by Downloading and Configuring the
-    latest release from GitHub.
-
 - :ref:`source_code_install`
 
     You can download/clone the source code repository via git/GitHub and then run a configure script
     to install ScanCode.
 
+- :ref:`pip_install`
+
+    To use ScanCode as a library in your application, you can install it via ``pip``. This is
+    recommended for developers/users familiar with Package managers/virtualenv.
+
 ----
 
 Before Installing
@@ -50,7 +49,7 @@ ScanCode needs a Python 3.6 (*highly recommended*) or a Python 2.7 interpreter.
 
 .. Note::
 
-    ScanCode currently doesn't support Python 3.7.x or 3.8.x, though support will be added soon.
+    ScanCode currently doesn't support versions above Python 3.6.x, though support will be added soon.
 
 - **On Linux**:
 
@@ -235,39 +234,6 @@ Un-installation
 
 ----
 
-.. _pip_install:
-
-Installation as a library: via ``pip``
---------------------------------------
-
-ScanCode can be easily installed using ``pip``. The steps are:
-
-#. Create a Python 3.6 Virtual Environment::
-
-    virtualenv -p /usr/bin/python3.6 venv-scancode
-
-For more information on Python virtualenv, visit this `page <https://docs.python-guide.org/dev/virtualenvs/#lower-level-virtualenv>`_.
-
-#. Activate the Virtual Environment you just created::
-
-    source venv-scancode/bin/activate
-
-#. Run ``pip install scancode-toolkit`` to install the latest version of Scancode.
-
-.. NOTE::
-
-    If you use Python 2.7, scancode-toolkit Version 3.0.2 is installed by default. For Python 3
-    the latest version of Scancode Toolkit is installed by default. Requesting a specific version
-    through ``pip install`` for Python 3 will give Errors if the Version isn't 3.1.x or later.
-
-.. WARNING::
-
-    Python 3.7.x and 3.8.x is not supported yet.
-
-To uninstall, run ``pip uninstall scancode-toolkit``.
-
-----
-
 .. _source_code_install:
 
 Installation from Source Code: Git Clone
@@ -327,6 +293,39 @@ Now you are ready to use the freshly configured scancode-toolkit.
 
 ----
 
+.. _pip_install:
+
+Installation as a library: via ``pip``
+--------------------------------------
+
+ScanCode can be installed using ``pip``, the default Python Package Manager. The steps are:
+
+#. Create a Python 3.6 Virtual Environment::
+
+    virtualenv -p /usr/bin/python3.6 venv-scancode
+
+For more information on Python virtualenv, visit this `page <https://docs.python-guide.org/dev/virtualenvs/#lower-level-virtualenv>`_.
+
+#. Activate the Virtual Environment you just created::
+
+    source venv-scancode/bin/activate
+
+#. Run ``pip install scancode-toolkit`` to install the latest version of Scancode.
+
+.. NOTE::
+
+    If you use Python 2.7, scancode-toolkit Version 3.0.2 is installed by default. For Python 3
+    the latest version of Scancode Toolkit is installed by default. Requesting a specific version
+    through ``pip install`` for Python 3 will give Errors if the Version isn't 3.1.x or later.
+
+.. WARNING::
+
+    Python 3.7.x and 3.8.x is not supported yet.
+
+To uninstall, run ``pip uninstall scancode-toolkit``.
+
+----
+
 .. _commands_variation:
 
 Commands Variation

docs/source/getting-started/newcomer.rst

@@ -16,7 +16,7 @@ Table of Contents
     - :ref:`newcomer_before`
     - :ref:`newcomer_install`
     - :ref:`newcomer_scan_codebase`
-    - :ref:`newcomer_use_scancode_better`
+    - :ref:`newcomer_scancode_tips`
     - :ref:`newcomer_all_tutorials`
     - :ref:`newcomer_whats_new`
 
@@ -48,7 +48,7 @@ determine their license, copyrights and other information, according to your req
 #. The :ref:`newcomer_scan_codebase` section helps you with configuring your virtual environment,
    installing Scancode and performing a basic scan, and subsequently visualize the results.
 
-#. The :ref:`newcomer_use_scancode_better` section helps you customize the scan according to your
+#. The :ref:`newcomer_scancode_tips` section helps you customize the scan according to your
    requirements, and better understand the advanced features you can use.
 
 #. The :ref:`newcomer_all_tutorials` is essentially an exhaustive list of all Tutorials and How To's
@@ -66,11 +66,11 @@ Scancode-Toolkit can be installed in 3 different methods.
 #. The :ref:`newcomer_scan_codebase` section helps you with configuring your virtual environment,
    installing Scancode and performing a basic scan, and subsequently visualize the results.
 
-#. The :ref:`newcomer_use_scancode_better` section helps you customize the scan according to your
+#. The :ref:`newcomer_scancode_tips` section helps you customize the scan according to your
    requirements, and better understand the advanced features you can use.
 
-#. The :ref:`newcomer_all_tutorials` is essentially an exhaustive list of all Tutorials and How To's
-   with a brief descrip
+#. The :ref:`newcomer_all_tutorials` is essentially an exhaustive list of all Tutorials and
+   How To's with a brief description.
 
 
 .. _newcomer_before:
@@ -120,7 +120,7 @@ Once you are all set up with Scancode Toolkit, i.e. Running ``scancode -h`` show
    `Scancode Workbench <https://github.com/nexB/scancode-workbench>`_. Follow this tutorial :ref:`how_to_visualize_scan_results`
    to visualize the scan results.
 
-.. _newcomer_use_scancode_better:
+.. _newcomer_scancode_tips:
 
 Use ScanCode Better
 ^^^^^^^^^^^^^^^^^^^

docs/source/getting-started/whats-new.rst

@@ -66,7 +66,8 @@ other languages. And as Scancode has users in more than 100 languages, this is a
 Better install Support
 ^^^^^^^^^^^^^^^^^^^^^^^
 
-Now, Downloading ScanCode as an Application is the recommended install method, across all platforms.
-This greatly simplifies the install process, and is much easier for all users. Developers familiar with
-package managers can also download ScanCode as a library, via ``pip`` or configure from the source. All
-these methods are properly documented, across all platforms and scenarios.
+Now, Downloading ScanCode as an Application is the recommended install method, across all
+platforms. This greatly simplifies the install process, and is much easier for all users.
+Developers familiar with package managers can also download ScanCode as a library, via ``pip``
+or configure from the source. All these methods are properly documented, across all platforms
+and scenarios.