NUnit Documentation

This repository serves the content that is found at https://docs.nunit.org.

What is the Docs site? How does it work?

The docs site is a project within the NUnit organization. Read the vision at VISION.md to understand more about how the documentation fits into the overall organization and how it supports the other projects.

How to Build these docs locally

Prerequisite: Install docfx (using Chocolatey? The command is choco install docfx -y)
Pull this repository
cd docs
Run docfx build
Run docfx serve and navigate to http://localhost:8080/_site

How to Build These Docs Within GitHub Codespaces

Fancy using GitHub Codespaces for your work on these docs? You can!

Open the branch you want to work on in GitHub Codespaces
The tooling, VS code extensions, etc. that we use will immediately be available to you.
To build from the Codespaces terminal: build (we've taken care of the rest for you)
To serve / preview from the Codespaces terminal: serve (we've taken care of the rest for you)
To run markdown linting from the Codespaces terminal: lint (we've taken care of the rest for you)
To run spellcheck from the Codespaces terminal: spellcheck (we've taken care of the rest for you)

We'll be working on follow-ups to make this more user-friendly, but it's now workable.

Linting Locally

Install markdownlint: npm install markdownlint-cli -g
Open the root of the project (/, not /docs)
Run markdownlint docs/**/*.md

We'd love your contributions! See The contributing guide for how to get involved.

How the Docs are Built and Deployed