docs: create Service_Document_Template
This commit is contained in:
parent
d85b984c71
commit
e3ee94cbf6
1 changed files with 122 additions and 0 deletions
122
Service_Document_Template.md
Normal file
122
Service_Document_Template.md
Normal file
|
|
@ -0,0 +1,122 @@
|
||||||
|
---
|
||||||
|
title: Service Documentation Template
|
||||||
|
description: Describe the service
|
||||||
|
published: true
|
||||||
|
date: 2026-02-03T02:57:07.462Z
|
||||||
|
tags:
|
||||||
|
editor: markdown
|
||||||
|
dateCreated: 2026-02-03T02:57:07.462Z
|
||||||
|
---
|
||||||
|
|
||||||
|
# Service Documentation Template
|
||||||
|
|
||||||
|
Use this template for **every new service** documented under `services/`.
|
||||||
|
|
||||||
|
Copy this file, rename it, and fill in all sections.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
# Service Name
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
Brief description of what this service does and why it exists.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Architecture
|
||||||
|
|
||||||
|
Describe how the service is deployed.
|
||||||
|
|
||||||
|
Include:
|
||||||
|
- Host(s)
|
||||||
|
- Containers
|
||||||
|
- External dependencies
|
||||||
|
- Network exposure
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Volumes & Data
|
||||||
|
|
||||||
|
List all persistent data locations.
|
||||||
|
```
|
||||||
|
/path/on/host → purpose
|
||||||
|
```
|
||||||
|
|
||||||
|
Include:
|
||||||
|
- What data is stored
|
||||||
|
- Whether it is critical
|
||||||
|
- Where backups occur
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
|
Document:
|
||||||
|
- Environment variables (non-secret)
|
||||||
|
- Configuration files
|
||||||
|
- Important defaults
|
||||||
|
|
||||||
|
**Secrets must not be stored here.** Reference where they live instead.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Authentication & Access
|
||||||
|
|
||||||
|
Describe:
|
||||||
|
- Authentication method
|
||||||
|
- Local access
|
||||||
|
- Break-glass access (if applicable)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Backups
|
||||||
|
|
||||||
|
Explain:
|
||||||
|
- What is backed up
|
||||||
|
- How often
|
||||||
|
- Using what tool
|
||||||
|
- Where backups are stored
|
||||||
|
|
||||||
|
Link to infrastructure backup docs if applicable.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Restore Procedure
|
||||||
|
|
||||||
|
Step-by-step recovery instructions.
|
||||||
|
```bash
|
||||||
|
# example commands
|
||||||
|
```
|
||||||
|
|
||||||
|
This section must be usable when the service is broken.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Monitoring & Health
|
||||||
|
|
||||||
|
Describe:
|
||||||
|
- How service health is checked
|
||||||
|
- Logs of interest
|
||||||
|
- Alerting (if any)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Common Failures
|
||||||
|
|
||||||
|
List known failure modes and fixes.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Diagrams
|
||||||
|
|
||||||
|
Embed architecture diagrams here.
|
||||||
|
```markdown
|
||||||
|

|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Notes
|
||||||
|
|
||||||
|
Anything that does not fit elsewhere.
|
||||||
Loading…
Add table
Add a link
Reference in a new issue