https://github.com/pester/docs
Source files for the Pester website.
https://github.com/pester/docs
Last synced: about 2 months ago
JSON representation
Source files for the Pester website.
- Host: GitHub
- URL: https://github.com/pester/docs
- Owner: pester
- License: mit
- Created: 2019-12-18T19:47:15.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2025-04-08T02:01:03.000Z (2 months ago)
- Last Synced: 2025-04-15T20:58:31.210Z (about 2 months ago)
- Language: MDX
- Homepage: https://pester.dev
- Size: 9.54 MB
- Stars: 41
- Watchers: 7
- Forks: 78
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- Contributing: docs/contributing/feature-requests.mdx
- License: LICENSE.txt
- Code of conduct: code_of_conduct.md
Awesome Lists containing this project
README
[](https://app.netlify.com/sites/pester-docs/deploys/40fe79e6-b973-4855-b0c7-f1ab101d1f0f)
[](https://www.contributor-covenant.org/version/2/0/code_of_conduct)
# Pester Docs
This repository contains the source files used to generate the [pester.dev](https://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](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_comment_based_help?view=powershell-7.1). Please do not create pull requests for these command reference pages here, but instead fix the corresponding
Pester PowerShell source code in [pester/Pester](https://github.com/pester/pester) repository. For example to change [Invoke-Pester command reference](https://pester.dev/docs/commands/Invoke-Pester), you need to change the help [in this file](https://github.com/pester/Pester/blob/main/src/Pester.ps1#L258-L276).
## Contributing
To submit an update:
1. update the markdown `.mdx` file(s)
2. submit a pull request
## Local Development
The website is built using:
- [Docusaurus 2](https://v2.docusaurus.io/), a modern static website generator written in React
- [Alt3.Docusaurus.Powershell](https://docusaurus-powershell.netlify.com/), a Powershell Get-Help to markdown generator
### Requirements
- [Node.js](https://nodejs.org/en/download/)
- [Yarn](https://yarnpkg.com/en/)
### Installation
To install all required dependencies and start a local development server:
```bash
yarn
yarn start
```
## Website Customization
Because the website is using Docusaurus as the underlying technology:
- please refer to the [Docusaurus 2 Documentation](https://v2.docusaurus.io/) for usage information
and available customization options
- please report technical issues at the [Docusaurus Repository](https://github.com/facebook/docusaurus/issues)
### 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](https://github.com/pester/docs/blob/main/docs/additional-resources/articles.table.js).
### Bumping Docusaurus
To upgrade docusaurus to a more recent version:
1. Edit `package.json`
2. Manually bump the version number of these dependency packages:
```json
@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 [email protected]. All complaints will be reviewed and investigated promptly and fairly.
[Read the full code of conduct](code_of_conduct.md)