wip: example ToC for maintainer guide

Author: mefellows

website/docs/implementation_guides/maintainer/checklist/readme.md

@@ -0,0 +1,21 @@
+---
+title: Checklist
+sidebar_label: Checklist
+---
+
+# Checklist
+
+## Hygiene
+
+* [ ] Project created from template
+* [ ] Documentation populated from template
+* [ ] Documentation synced via automation to docs.pact.io
+* [ ] Issue templates added
+* [ ] Labels added
+* [ ] Example projects created
+* [ ] Tutorials/workshops to get started
+* [ ] Supports minimum OS/Arch combinations?
+
+## Quality
+
+* [ ] TCK completed and published

website/docs/implementation_guides/maintainer/dsl/consumer/readme.md

@@ -0,0 +1,10 @@
+---
+title: Consumer
+sidebar_label: Consumer
+---
+
+# Consumer DSL
+
+- General consumer guidance
+- Matching Rules
+- Specification versions and how this impacts the DSL

website/docs/implementation_guides/maintainer/dsl/http/readme.md

@@ -0,0 +1,13 @@
+---
+title: HTTP
+sidebar_label: HTTP
+---
+
+# HTTP DSL
+
+## Consumer
+TBC
+
+## Provider
+
+TBC

website/docs/implementation_guides/maintainer/dsl/message/readme.md

@@ -0,0 +1,13 @@
+---
+title: Message
+sidebar_label: Message
+---
+
+# Message DSL
+
+## Consumer
+TBC
+
+## Provider
+
+TBC

website/docs/implementation_guides/maintainer/dsl/plugins/readme.md

@@ -0,0 +1,13 @@
+---
+title: Plugins
+sidebar_label: Plugins
+---
+
+# Plugins DSL
+
+## Consumer
+TBC
+
+## Provider
+
+TBC

website/docs/implementation_guides/maintainer/dsl/provider/readme.md

@@ -0,0 +1,16 @@
+---
+title: Provider
+sidebar_label: Provider
+---
+
+# Provider DSL
+
+- General provider guidance e.g.
+  - Pact fetching guidance (local, broker etc.)
+  - how to setup `pactffi_verifier_set_provider_info` and `pactffi_verifier_add_provider_transport` effectively to support multiple transports
+  - state handlers, request filters
+- FFI calls
+- Transports (multiple, how they work, default host/port)
+- State Handlers (setup/teardown, use as hooks, and behaviour if there are no states)
+
+  see https://pact-foundation.slack.com/archives/C02BXLDJ7JR/p1683037785422899 and https://pact-foundation.slack.com/archives/C02BXLDJ7JR/p1683282113939749 for more on this

website/docs/implementation_guides/maintainer/dsl/readme.md

@@ -0,0 +1,12 @@
+---
+title: DSL
+sidebar_label: Introduction
+---
+
+# DSL
+
+DSL Implementation
+
+Covers Pact nomenclature vs idiomatic naming of things, how to cater for different spec versions, and FFI methods to call.
+
+*NOTE: It might make sense to split by consumer/provider, rather than use case*

website/docs/implementation_guides/maintainer/example/readme.md

@@ -0,0 +1,8 @@
+---
+title: Example
+sidebar_label: Example
+---
+
+## Reference Example
+
+-> Annotated Pact JS/Pact Node code base

website/docs/implementation_guides/maintainer/ffi/readme.md

@@ -0,0 +1,14 @@
+---
+title: FFI
+sidebar_label: FFI
+---
+
+## FFI (Framework? SDK?)
+
+- Introduction to the Pact Reference implementation /  SDK framework / FFI
+- Hello FFI (https://github.com/YOU54F/hello_ffi)
+- Getting started (where to find, download)
+- Ergonomics (make it easy on the end user)
+- General usage, boundaries between FFI and Application
+- Setting up for logging, debugging etc.
+- Specific methods to call (or should this be spread across the DSL implementation?)

website/docs/implementation_guides/maintainer/general/readme.md

@@ -0,0 +1,14 @@
+---
+title: General
+sidebar_label: General
+---
+
+## General
+
+- Language / Naming Things / Idioms
+- Minimum supported OS/Arch combinations
+- Logging
+- Debugging
+- Repository hygiene (issue labels, triage etc.)
+- Specification versions
+  - A short comparison between the different versions, and how this should be considered in API/DSL design