You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
consul/contributing
Daniel Nephin b93f9d8788
contrib: add first draft of agent configuration docs
3 years ago
..
acl contrib: add first draft of ACL docs 3 years ago
cli contrib: Add CLI docs 3 years ago
client-agent contributing: start an outline for more docs 3 years ago
cluster-federation contributing: start an outline for more docs 3 years ago
cluster-membership contributing: start an outline for more docs 3 years ago
config contrib: add first draft of agent configuration docs 3 years ago
http-api contrib: Add CLI docs 3 years ago
persistence contrib: Add cluster persistence docs 3 years ago
rpc contrib: add first draft of RPC docs 3 years ago
service-discovery contributing: start an outline for more docs 3 years ago
service-mesh contributing: start an outline for more docs 3 years ago
INTERNALS.md contrib: add first draft of ACL docs 3 years ago
README.md contrib: add docs about the diagrams 3 years ago
consul-mermaid-theme.json contrib: add first draft of ACL docs 3 years ago
faq.md contrib: move FAQ into a separate file. 3 years ago
overview.mmd Fix typo in overview diagram 3 years ago
overview.svg Fix typo in overview diagram 3 years ago

README.md

Contributing to Consul

See our contributing guide to get started.

This directory contains documentation intended for anyone interested in understanding, and contributing changes to, the Consul codebase.

Overview

This documentation is organized into the following categories. Each category is either a significant architectural layer, or major functional area of Consul. These documents assume a basic understanding of Consul's feature set, which can found in the public user documentation.

Overview

source

Contents

  1. Overview
  2. Command-Line Interface (CLI)
  3. HTTP API
  4. Agent Configuration
  5. RPC
  6. Cluster Persistence
  7. Client Agent
  8. Service Discovery
  9. Service Mesh (Connect)
  10. Cluster Membership
  11. Key/Value Store
  12. ACL
  13. Multi-Cluster Federation

Also see the FAQ.

Contributing to these docs

This section is meta documentation about contributing to these docs.

Diagrams

The diagrams in these documents are created using the mermaid-js live editor. The mermaid-js docs provide a complete reference for how to create and edit the diagrams. Use the consul-mermaid-theme.json (paste it into the Config tab in the editor) to maintain a consistent Consul style for the diagrams.