Import wpt@9c292953722dee25858a667417d2502ed418f235

third_party/WebKit/LayoutTests/imported/wpt/README.md

 The Web Platform Tests Project [![IRC chat](https://goo.gl/6nCIks)](http://irc.w3.org/?channels=testing)
 ==============================
 
 The Web Platform Tests Project is a W3C-coordinated attempt to build a
 cross-browser testsuite for the Web-platform stack.  However, for mainly
 historic reasons, the CSS WG testsuite is in a separate repository,
 [csswg-test](https://github.com/w3c/csswg-test). Writing tests in a way
 that allows them to be run in all browsers gives browser projects
 confidence that they are shipping software that is compatible with other
 implementations, and that later implementations will be compatible with
 their implementations. This in turn gives Web authors/developers
 confidence that they can actually rely on the Web platform to deliver on
 the promise of working across browsers and devices without needing extra
 layers of abstraction to paper over the gaps left by specification
 editors and implementors.
 
 Running the Tests
 =================
 
 The tests are designed to be run from your local computer. The test
-environment requires Python 2.7+ (but not Python 3.x). You will also
-need a copy of OpenSSL. Users on Windows should read the
-[Windows Notes](#windows-notes) section below.
+environment requires [Python 2.7+](http://www.python.org/downloads) (but not Python 3.x).
+You will also need a copy of OpenSSL.
+
+On Windows, be sure to add the Python directory (`c:\python2x`, by default) to
+your `%Path%` [Environment Variable](http://www.computerhope.com/issues/ch000549.htm),
+and read the [Windows Notes](#windows-notes) section below.
 
 To get the tests running, you need to set up the test domains in your
 [`hosts` file](http://en.wikipedia.org/wiki/Hosts_%28file%29%23Location_in_the_file_system). The
 following entries are required:
 
 ```
 127.0.0.1   web-platform.test
 127.0.0.1   www.web-platform.test
 127.0.0.1   www1.web-platform.test
 127.0.0.1   www2.web-platform.test
@@ skipping 39 matching lines @@
 "ssl": {"openssl": {"binary": "/path/to/openssl"}}
 ```
 
 <span id="windows-notes">Windows Notes</span>
 =============================================
 
 Running wptserve with SSL enabled on Windows typically requires
 installing an OpenSSL distribution.
 [Shining Light](https://slproweb.com/products/Win32OpenSSL.html)
 provide a convenient installer that is known to work, but requires a
-little extra setup.
+little extra setup, i.e.:
 
-After installation ensure that the path to OpenSSL is on your `%Path%`
-environment variable.
+Run the installer for Win32_OpenSSL_v1.1.0b (30MB). During installation,
+change the default location for where to Copy OpenSSL Dlls from the
+System directory to the /bin directory.
 
-Then set the path to the default OpenSSL configuration file (usually
-something like `C:\OpenSSL-Win32\bin\openssl.cfg` in the server
-configuration. To do this copy `config.default.json` in the
-web-platform-tests root to `config.json`. Then edit the JSON so that
-the key `ssl/openssl/base_conf_path` has a value that is the path to
-the OpenSSL config file.
+After installation, ensure that the path to OpenSSL (typically,
+this will be `C:\OpenSSL-Win32\bin`) is in your `%Path%`
+[Environment Variable](http://www.computerhope.com/issues/ch000549.htm).
+If you forget to do this part, you will most likely see a 'File Not Found'
+error when you start wptserve.
+
+Finally, set the path value in the server configuration file to the
+default OpenSSL configuration file location. To do this,
+copy `config.default.json` in the web-platform-tests root to `config.json`.
+Then edit the JSON so that the key `ssl/openssl/base_conf_path` has a
+value that is the path to the OpenSSL config file (typically this
+will be `C:\\OpenSSL-Win32\\bin\\openssl.cfg`).
 
 Alternatively, you may also use
 [Bash on Ubuntu on Windows](https://msdn.microsoft.com/en-us/commandline/wsl/about)
 in the Windows 10 Anniversary Update build, then access your windows
 partition from there to launch wptserve.
 
 Test Runner
 ===========
 
 There is a test runner that is designed to provide a
@@ skipping 151 matching lines @@
 [contributing]: https://github.com/w3c/web-platform-tests/blob/master/CONTRIBUTING.md
 [ircw3org]: https://www.w3.org/wiki/IRC
 [ircarchive]: http://krijnhoetmer.nl/irc-logs/testing/
 [mailarchive]: http://lists.w3.org/Archives/Public/public-test-infra/
 
 Documentation
 =============
 
 * [How to write and review tests](http://testthewebforward.org/docs/)
 * [Documentation for the wptserve server](http://wptserve.readthedocs.org/en/latest/)