Skip to content
/ docs Public

Source files for the Pester website.

License

Notifications You must be signed in to change notification settings

pester/docs

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Folders and files

NameName
Last commit message
Last commit date
Oct 21, 2023
Jul 2, 2022
Mar 22, 2021
Jun 10, 2024
Mar 30, 2024
Feb 11, 2023
Jun 8, 2024
Jun 8, 2024
Jun 8, 2024
Dec 21, 2019
Dec 21, 2019
Sep 22, 2023
Feb 9, 2020
Dec 21, 2019
Apr 26, 2023
Jun 15, 2021
Sep 21, 2020
Jun 8, 2024
Mar 28, 2023
Mar 11, 2024
Jan 31, 2024
Jun 10, 2024
Jun 8, 2024
Mar 29, 2024

Repository files navigation

Netlify Contributor Covenant

Pester Docs

This repository contains the source files used to generate the pester.dev website.

The website pages are written in markdown files using the .mdx format and are located in the /docs folder.

🔥 One exception: the pages in the "Command Reference" section are auto-generated from Pester's Comment Based Help. Please do not create pull requests for these command reference pages here, but instead fix the corresponding Pester PowerShell source code in pester/Pester repository. For example to change Invoke-Pester command reference, you need to change the help in this file.

Contributing

To submit an update:

  1. update the markdown .mdx file(s)
  2. submit a pull request

Local Development

The website is built using:

Requirements

Installation

To install all required dependencies and start a local development server:

yarn
yarn start

Website Customization

Because the website is using Docusaurus as the underlying technology:

Styling

The global CSS overrides for the Pester website are found in src/css/custom.css

Tables

The Pester website uses interactive React tables. To change the content of the tables, simply update the correlating .json configuration file as can be seen in this example.

Bumping Docusaurus

To upgrade docusaurus to a more recent version:

  1. Edit package.json
  2. Manually bump the version number of these dependency packages:
    @docusaurus/core": "^2.2.0",
    @docusaurus/preset-classic": "^2.2.0",
  3. Run yarn install
  4. Submit a pull request with (only) these updated files:
    • package.json
    • yarn.lock

Code of Conduct

In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.

Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at coc@pester.dev. All complaints will be reviewed and investigated promptly and fairly.

Read the full code of conduct