Need help with webpagetest-docs?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

WPO-Foundation
161 Stars 55 Forks Apache License 2.0 257 Commits 3 Opened issues

Description

Documentation for WebPageTest

Services available

!
?

Need anything else?

Contributors list

WebPageTest Logo

Official WebPageTest Documentation

The source for the official Documentation for WebPageTest.

View the docs →

About docs.webpagetest.org

Each page of documentation for WebPageTest is written in Markdown and contained in the /src directory. The site is built with Eleventy and automatically deployed by Netlify whenever a commit is pushed to the

main
branch.

Contributing to the documentation

We not only welcome, but encourage contributions to the documentation. There are two ways to contribute.

1. Via the "Edit on GitHub" links

Each page on the documentation site provides an "Edit this page on GitHub" link in the footer that will automatically take you to that page's source file in this repo.

From there, once you're logged into GitHub, you'll be able to click the pencil icon in the top right corner of the file to start editing in your browser. Once you're happy with your edits, add a title and informative description in the boxes provided by GitHub to submit a PR for us to review.

2. Running the site locally

Alternatively, you can set up a local development environment to make changes locally and then push up to the repo for review.

To run the site locally, you'll need to have version 8 or later of Node.js available on your machine.

Here are the steps necessary to get a version of the docs running on your local machine.

  1. Create a fork of this repo
  2. Clone your new repository to your local machine.
    git clone [email protected]:your-user-name/webpagetest-docs.git
    
  3. cd
    into
    webpagetest-docs
    and run
    npm install
    $ cd webpagetest-docs
    $ npm install
    
  4. Use
    npx
    to serve the site.
    npx
    has been included with Node since version 5.2. If for some reason it isn't available on your machine, you can install it by using
    npm install -g npx
npx @11ty/eleventy --serve

If all goes well, that should provide a hot-reloading local web server. As you make changes to the site, the site will auto-regenerate and the browser will fresh to show any changes. When you've made your changes, push them back to your forked version of the site and submit a pull request for us to review.

Looking for popular documentation?

Because of the change to the documentation, some links will be pointing to a path that no longer exists in this repo. To help you get oriented, here a few a of the more popular sections with their new canonical locations.

WebPageTest Change Log

View the Change Log for WebPageTest.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.