rendered all .md and added a search box

new-website/.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true

new-website/.eslintignore

@@ -0,0 +1,15 @@
+test/assets/modernizr.js
+third_party/*
+utils/browser/puppeteer-web.js
+utils/doclint/check_public_api/test/
+node6/*
+node6-test/*
+experimental/
+lib/
+/index.d.ts
+# We ignore this file because it uses ES imports which we don't yet use
+# in the Puppeteer src, so it trips up the ESLint-TypeScript parser.
+utils/doclint/generate_types/test/test.ts
+vendor/
+web-test-runner.config.mjs
+test-ts-types/

new-website/.eslintrc.js

@@ -0,0 +1,185 @@
+module.exports = {
+  root: true,
+  env: {
+    node: true,
+    es6: true,
+  },
+
+  parser: '@typescript-eslint/parser',
+
+  plugins: ['mocha', '@typescript-eslint', 'unicorn', 'import'],
+
+  extends: ['plugin:prettier/recommended'],
+
+  rules: {
+    // Error if files are not formatted with Prettier correctly.
+    'prettier/prettier': 2,
+    // syntax preferences
+    quotes: [
+      2,
+      'single',
+      {
+        avoidEscape: true,
+        allowTemplateLiterals: true,
+      },
+    ],
+    'spaced-comment': [
+      2,
+      'always',
+      {
+        markers: ['*'],
+      },
+    ],
+    eqeqeq: [2],
+    'accessor-pairs': [
+      2,
+      {
+        getWithoutSet: false,
+        setWithoutGet: false,
+      },
+    ],
+    'new-parens': 2,
+    'func-call-spacing': 2,
+    'prefer-const': 2,
+
+    'max-len': [
+      2,
+      {
+        /* this setting doesn't impact things as we use Prettier to format
+         * our code and hence dictate the line length.
+         * Prettier aims for 80 but sometimes makes the decision to go just
+         * over 80 chars as it decides that's better than wrapping. ESLint's
+         * rule defaults to 80 but therefore conflicts with Prettier. So we
+         * set it to something far higher than Prettier would allow to avoid
+         * it causing issues and conflicting with Prettier.
+         */
+        code: 200,
+        comments: 90,
+        ignoreTemplateLiterals: true,
+        ignoreUrls: true,
+        ignoreStrings: true,
+        ignoreRegExpLiterals: true,
+      },
+    ],
+    // anti-patterns
+    'no-var': 2,
+    'no-with': 2,
+    'no-multi-str': 2,
+    'no-caller': 2,
+    'no-implied-eval': 2,
+    'no-labels': 2,
+    'no-new-object': 2,
+    'no-octal-escape': 2,
+    'no-self-compare': 2,
+    'no-shadow-restricted-names': 2,
+    'no-cond-assign': 2,
+    'no-debugger': 2,
+    'no-dupe-keys': 2,
+    'no-duplicate-case': 2,
+    'no-empty-character-class': 2,
+    'no-unreachable': 2,
+    'no-unsafe-negation': 2,
+    radix: 2,
+    'valid-typeof': 2,
+    'no-unused-vars': [
+      2,
+      {
+        args: 'none',
+        vars: 'local',
+        varsIgnorePattern:
+          '([fx]?describe|[fx]?it|beforeAll|beforeEach|afterAll|afterEach)',
+      },
+    ],
+    'no-implicit-globals': [2],
+
+    // es2015 features
+    'require-yield': 2,
+    'template-curly-spacing': [2, 'never'],
+
+    // ensure we don't have any it.only or describe.only in prod
+    'mocha/no-exclusive-tests': 'error',
+
+    // enforce the variable in a catch block is named error
+    'unicorn/catch-error-name': 'error',
+
+    'no-restricted-imports': [
+      'error',
+      {
+        patterns: ['*Events'],
+        paths: [
+          {
+            name: 'mitt',
+            message:
+              'Import Mitt from the vendored location: vendor/mitt/src/index.js',
+          },
+        ],
+      },
+    ],
+    'import/extensions': ['error', 'ignorePackages'],
+  },
+  overrides: [
+    {
+      files: ['*.ts'],
+      extends: [
+        'plugin:@typescript-eslint/eslint-recommended',
+        'plugin:@typescript-eslint/recommended',
+      ],
+      rules: {
+        'no-unused-vars': 0,
+        '@typescript-eslint/no-unused-vars': 2,
+        'func-call-spacing': 0,
+        '@typescript-eslint/func-call-spacing': 2,
+        semi: 0,
+        '@typescript-eslint/semi': 2,
+        '@typescript-eslint/no-empty-function': 0,
+        '@typescript-eslint/no-use-before-define': 0,
+        // We have to use any on some types so the warning isn't valuable.
+        '@typescript-eslint/no-explicit-any': 0,
+        // We don't require explicit return types on basic functions or
+        // dummy functions in tests, for example
+        '@typescript-eslint/explicit-function-return-type': 0,
+        // We know it's bad and use it very sparingly but it's needed :(
+        '@typescript-eslint/ban-ts-ignore': 0,
+        /**
+         * This is the default options (as per
+         * https://github.com/typescript-eslint/typescript-eslint/blob/master/packages/eslint-plugin/docs/rules/ban-types.md),
+         *
+         * Unfortunately there's no way to
+         */
+        '@typescript-eslint/ban-types': [
+          'error',
+          {
+            extendDefaults: true,
+            types: {
+              /*
+               * Puppeteer's API accepts generic functions in many places so it's
+               * not a useful linting rule to ban the `Function` type. This turns off
+               * the banning of the `Function` type which is a default rule.
+               */
+              Function: false,
+            },
+          },
+        ],
+        '@typescript-eslint/array-type': [
+          2,
+          {
+            default: 'array-simple',
+          },
+        ],
+        // By default this is a warning but we want it to error.
+        '@typescript-eslint/explicit-module-boundary-types': 2,
+      },
+    },
+    {
+      files: ['test-browser/**/*.js'],
+      parserOptions: {
+        sourceType: 'module',
+      },
+      env: {
+        es6: true,
+        browser: true,
+        es2020: true,
+      },
+    },
+  ],
+};

new-website/.gitattributes

@@ -0,0 +1,2 @@
+# Declare files that will always have LF line endings on checkout.
+*.txt eol=lf

new-website/.github/workflows/main.yml

@@ -0,0 +1,175 @@
+name: run-checks
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  linux-main-checks:
+    # https://github.com/actions/virtual-environments#available-environments
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        # Include all major maintenance + active LTS + current Node.js versions.
+        # https://github.com/nodejs/Release#release-schedule
+        node: [12, 14, 16]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 2
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v1
+        with:
+          node-version: ${{ matrix.node }}
+
+      - name: Install dependencies
+        run: |
+          sudo apt-get install xvfb
+          # Ensure both a Chromium and a Firefox binary are available.
+          PUPPETEER_PRODUCT=firefox npm install
+          npm install
+          ls .local-chromium .local-firefox
+
+      - name: Build
+        run: |
+          npm run build
+
+      - name: Run code checks
+        run: |
+          npm run ensure-pinned-deps
+          npm run lint
+          npm run generate-docs
+          npm run ensure-correct-devtools-protocol-revision
+          npm run test-types-file
+
+      - name: Run unit tests
+        uses: nick-invision/retry@v2
+        env:
+          CHROMIUM: true
+        with:
+          max_attempts: 3
+          command: xvfb-run --auto-servernum npm run unit
+          timeout_minutes: 10
+
+      - name: Run unit tests with coverage
+        env:
+          CHROMIUM: true
+        run: |
+          xvfb-run --auto-servernum npm run unit-with-coverage
+          xvfb-run --auto-servernum npm run assert-unit-coverage
+
+      - name: Run unit tests on Firefox
+        uses: nick-invision/retry@v2
+        env:
+          FIREFOX: true
+          MOZ_WEBRENDER: 0
+        with:
+          max_attempts: 3
+          timeout_minutes: 10
+          command: xvfb-run --auto-servernum npm run funit
+
+      - name: Run browser tests
+        run: |
+          npm run test-browser
+
+      - name: Test bundling and installation
+        env:
+          CHROMIUM: true
+        run: |
+          # Note: this modifies package.json to test puppeteer-core.
+          npm run test-install
+          # Undo those changes.
+          git checkout --force
+
+  macos:
+    # https://github.com/actions/virtual-environments#available-environments
+    runs-on: macos-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 2
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v1
+        with:
+          # Test only the oldest maintenance LTS Node.js version.
+          # https://github.com/nodejs/Release#release-schedule
+          node-version: 12
+
+      - name: Install dependencies
+        run: |
+          # Test platform-specific browser binary fetching for both
+          # Chromium and Firefox.
+          PUPPETEER_PRODUCT=firefox npm install
+          npm install
+          ls .local-chromium .local-firefox
+
+      - name: Build
+        run: |
+          npm run build
+
+      - name: Run unit tests
+        env:
+          CHROMIUM: true
+        run: |
+          npm run unit
+
+      - name: Run unit tests on Firefox
+        uses: nick-invision/retry@v2
+        with:
+          max_attempts: 3
+          timeout_minutes: 10
+          command: npm run funit
+
+  windows:
+    # https://github.com/actions/virtual-environments#available-environments
+    runs-on: windows-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 2
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v1
+        with:
+          # Test only the oldest maintenance LTS Node.js version.
+          # https://github.com/nodejs/Release#release-schedule
+          node-version: 12
+
+      - name: Install dependencies
+        run: |
+          # Test platform-specific browser binary fetching for both
+          # Chromium and Firefox.
+          $env:PUPPETEER_PRODUCT='firefox'
+          npm install
+          Remove-Item Env:\PUPPETEER_PRODUCT
+          npm install
+          Get-ChildItem -Path .local-chromium,.local-firefox
+
+      - name: Build
+        run: |
+          npm run build
+
+      - name: Run unit tests
+        env:
+          CHROMIUM: true
+        run: |
+          npm run unit
+
+      - name: Run unit tests on Firefox
+        uses: nick-invision/retry@v2
+        env:
+          FIREFOX: true
+          MOZ_WEBRENDER: 0
+        with:
+          max_attempts: 3
+          timeout_minutes: 10
+          command: npm run funit