Changes between Version 44 and Version 45 of TracDev/DevelopmentEnvironmentSetup

Timestamp:

Mar 1, 2023, 9:26:12 AM (14 months ago)

Author:

figaro

Comment:

Cosmetic changes

TracDev/DevelopmentEnvironmentSetup

@@ -27 +27 @@
 === Get Python
 
-On Linux, you'll usually want to install Python using the package manager for your distribution. For example, on a distribution utilizing the Apt package manager (Debian, Ubuntu):
+On Linux install Python using the package manager for your distribution. For example, on a distribution utilizing the Apt package manager (Debian, Ubuntu):
 {{{#!sh
 $ sudo apt-get install python
 }}}
 
-You will also need some additional libraries:
+You will also need additional libraries:
 {{{#!sh
 $ sudo apt-get install python-subversion
@@ -45 +45 @@
 === Get pip
 
-You'll already have `pip` installed with Python >= 2.7.9. If you are running an earlier version of Python, first check whether `pip` is already installed:
+You will already have `pip` installed with Python >= 2.7.9. If you are running an earlier version of Python, first check whether `pip` is already installed:
 {{{#!sh
 $ pip --version
@@ -53 +53 @@
 === Get virtualenv
 
-You may already have `virtualenv` installed.
+`virtualenv` is a tool to create isolated Python environments and allows you to test out Trac code or Python code in general without risk of data loss to the rest of your computer. You may already have `virtualenv` installed:
 {{{#!sh
 $ virtualenv --version
@@ -79 +79 @@
 }}}
 
-You'll see your command-line prompt has changed. That means your environment is ready for Trac.
+You will see your command-line prompt prefixed with `(pve)` or similar. That means you have entered the virtual environment and your environment is ready for Trac installation and development.
 
-=== Upgrade Dependencies
+=== Upgrade dependencies
 
-Upgrade the dependencies in your environment.
+Upgrade the dependencies in your environment:
 {{{#!sh
 $ pip install -U pip setuptools wheel
@@ -90 +90 @@
 == Developing with Eclipse and !PyDev
 
-If you are planning to develop using Eclipse, you should also read the [TracDev/DevelopmentWithEclipseAndPyDev Development with Eclipse and PyDev] page, after installing and configuring Trac in the next section.
+If you are planning to develop using the Eclipse IDE, you should also read the [TracDev/DevelopmentWithEclipseAndPyDev Development with Eclipse and PyDev] page, after installing and configuring Trac in the next section.
 
 == Installing and configuring Trac
@@ -96 +96 @@
 === Download Trac
 
-You should get the Trac source code from one of the TracRepositories. For example, to checkout from Subversion using the command-line:
+Get the Trac source code from one of the TracRepositories. For example, to checkout from Subversion using the command-line:
 {{{#!sh
 $ svn co https://svn.edgewall.org/repos/trac/trunk/ trac-trunk
@@ -125 +125 @@
 }}}
 
-'''Note:''' Don't do this in production!
+'''Note:''' Don't do this in a production environment!
 
 === Install the [th:TracDeveloperPlugin] (optional)
@@ -159 +159 @@
 === Open Trac in your browser
 
-Switch to your browser and go to `http://127.0.0.1:8000/` 
+Switch to your browser and go to `http://127.0.0.1:8000/`. You should see the Trac landing page.
 
 Now do the following:
@@ -170 +170 @@
 === Alternative frontends
 
-To develop on Trac with Apache rather than the standalone `tracd`, see the [TracDev/AlternativeFrontends alternative frontends] page for information on using Apache with mod_python and mod_wsgi.
+To develop on Trac with Apache rather than the standalone `tracd`, see the [TracDev/AlternativeFrontends alternative frontends] page for information on using Apache with `mod_python` and `mod_wsgi`.
 
 == Further guidelines