Skip to content

pendsley/docs.pact.io

 
 

Repository files navigation

Pact Docs Website

Netlify Status

Sync Pact docs

Local development

The files are markdown, stored under the docs directory.

You will need Docker and Docker Compose to run the docs application locally.

docker-compose up

Adding pages

Moving pages

  • Find the file under the docs directory.
  • Move it to the directory/name you want.
  • Update website/sidebars.json.
  • Do a file search and replace to update any internal references to the page.
  • Create a redirect in netlify.toml.

Automatic syncing from the markdown files in each Pact implementation repository

The markdown files in the following directories are synced from their respective source repositories. Do not edit them directly! You'll be able to tell if it's a file that has been synced from another repository because the custom_edit_url will be set in the page metadata.

  • docs/implementation_guides/go
  • docs/implementation_guides/javascript
  • docs/implementation_guides/jvm
  • docs/implementation_guides/python
  • docs/implementation_guides/cpp
  • docs/implementation_guides/rust
  • docs/implementation_guides/net
  • docs/pact_broker/client_cli
  • docs/pact_broker/docker_images/

Each of the above Pact repositories has a Github workflow that triggers the sync-docs workflow when any markdown files are edited on master.

When the sync-docs workflow runs, it pulls in the master markdown files from the changed repository, syncs and processes them, and then commits and pushes them. On push, Netlify automatically deploys.

Hosting

The Pact docs site is hosted by Netlify. Thanks!

The site will be automatically redeployed after any push to master.

Deploys by Netlify

Search

The search is provided free by Algolia because Pact is an open source project. It is configured in docs.pact.io in website/siteConfig.js. It is configured in Algolia in https://github.com/algolia/docsearch-configs/blob/master/configs/pact.json The Algolia analytics page is here. Currently only Beth has access to it via her Github login. We may be able to add extra people, but she hasn't looked into that yet. Info on how to style the search UI is here.

Contributing

See CONTRIBUTING.md

Contact

About

Pact documentation website

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 88.3%
  • JavaScript 6.3%
  • CSS 3.2%
  • Ruby 2.1%
  • Shell 0.1%
  • Makefile 0.0%