Github user SolidWallOfCode commented on a diff in the pull request:
https://github.com/apache/trafficserver/pull/1465#discussion_r103799188
--- Diff: tests/getting_started.md ---
@@ -0,0 +1,197 @@
+
+# Getting Started
+
+This directory contains different tests for Apache Trafficserver. It is
recommended that all test move to this common area under the correct location
based on the type of test being added.
+
+## Layout
+The current layout is:
+
+**gold_tests/** - contains all the TSQA v4 based tests that run on the
Reusable Gold Testing System (AuTest)
+**tools/** - contain programs used to help with testing.
+
+In the future a directory called **"unit/"** will be added for adding unit
tests based on some standardized testing system.
+
+
+## Scripts
+
+To help with easy running of the tests, there is a autest.sh and
bootstrap.py file.
+
+### autest.sh
+This file is a simple wrapper that will call the AuTest program in a
python virtualenv. If the virtualenv is not setup it will try to install
system. That will set up the Reusable Gold Testing System on most systems in a
Python virtual environment. The wrapper add some basic options to the command
to point to the location of the tests. Add --help for more details on options
for running autest test system.
+
+### bootstrap.py
+This script should try to install python35 or better on the system, and
needed python packages for running the tests.
+
+# Advance setup
+
+AuTest can be install manually instead of using the wrapper script. The
advange of this is that it is often easier to debug issues with the testing
system, or the tests. There are two ways this can be done.
+1. run the bootstrap script then source the path with a "source
/env-test/bin/activate" command. At this point autest command should run
without the wrapper script
--- End diff --
This really installs stuff in `/env-test`? That seems unfriendly.
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---
