@amiable-dev/docusaurus-plugin-stentorosaur 0.17.0 → 0.18.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/lib/theme/StatusItem/MiniHeatmap.module.css +10 -12
- package/lib/version.d.ts +1 -1
- package/lib/version.js +1 -1
- package/package.json +10 -2
- package/scripts/bootstrap-summary.js +0 -0
- package/scripts/config.js +359 -0
- package/scripts/init.js +58 -0
- package/src/plugin-status.d.ts +127 -0
- package/templates/Makefile.status +146 -0
- package/templates/README.md +96 -0
- package/.notifyrc.example.json +0 -43
- package/ANALYSIS-MANIFEST.txt +0 -358
- package/ARCHITECTURE-DIAGRAM.txt +0 -220
- package/QUICKSTART.md +0 -440
- package/copyUntypedFiles.js +0 -24
- package/docs/README.md +0 -122
- package/docs/reference/CONFIGURATION.md +0 -994
- package/jest.setup.js +0 -17
- package/settings.json +0 -5
- package/tsconfig.tsbuildinfo +0 -1
package/docs/README.md
DELETED
|
@@ -1,122 +0,0 @@
|
|
|
1
|
-
# Documentation Index
|
|
2
|
-
|
|
3
|
-
This directory contains comprehensive documentation for the Docusaurus Status Plugin (Stentorosaur).
|
|
4
|
-
|
|
5
|
-
## Quick Access
|
|
6
|
-
|
|
7
|
-
**New to the project?** Start with the root-level documentation:
|
|
8
|
-
- [README.md](../README.md) - Project overview and installation
|
|
9
|
-
- [QUICKSTART.md](../QUICKSTART.md) - Get started in 5 minutes
|
|
10
|
-
- [CONTRIBUTING.md](../CONTRIBUTING.md) - How to contribute
|
|
11
|
-
- [CHANGELOG.md](../CHANGELOG.md) - Version history
|
|
12
|
-
|
|
13
|
-
## Directory Structure
|
|
14
|
-
|
|
15
|
-
### `/architecture` - System Design Documentation
|
|
16
|
-
|
|
17
|
-
Understanding how the plugin works internally:
|
|
18
|
-
|
|
19
|
-
- [ARCHITECTURE-INDEX.md](./architecture/ARCHITECTURE-INDEX.md) - Overview of architectural documentation
|
|
20
|
-
- [ARCHITECTURE-SUMMARY.md](./architecture/ARCHITECTURE-SUMMARY.md) - High-level system design
|
|
21
|
-
- [ARCHITECTURE-ANALYSIS.md](./architecture/ARCHITECTURE-ANALYSIS.md) - Detailed technical analysis
|
|
22
|
-
|
|
23
|
-
**When to read:** Understanding internal design, making architectural decisions, or contributing significant features.
|
|
24
|
-
|
|
25
|
-
### `/setup` - Advanced Setup Guides
|
|
26
|
-
|
|
27
|
-
Step-by-step guides for specific deployment scenarios:
|
|
28
|
-
|
|
29
|
-
- [ORPHANED_BRANCH_SETUP.md](./setup/ORPHANED_BRANCH_SETUP.md) - Upptime-style status-data branch configuration
|
|
30
|
-
- [TRUSTED_PUBLISHING_SETUP.md](./setup/TRUSTED_PUBLISHING_SETUP.md) - npm OIDC publishing configuration
|
|
31
|
-
- [PUBLISHING.md](./setup/PUBLISHING.md) - Release and publishing workflow
|
|
32
|
-
|
|
33
|
-
**When to read:** Setting up production deployments, configuring CI/CD, or preparing for release.
|
|
34
|
-
|
|
35
|
-
### `/reference` - Feature Documentation
|
|
36
|
-
|
|
37
|
-
Detailed documentation for specific features:
|
|
38
|
-
|
|
39
|
-
- [CONFIGURATION.md](./reference/CONFIGURATION.md) - Complete configuration options reference
|
|
40
|
-
- [TESTING.md](./reference/TESTING.md) - Testing strategy and guidelines
|
|
41
|
-
- [MONITORING_SYSTEM.md](./reference/MONITORING_SYSTEM.md) - Automated monitoring architecture
|
|
42
|
-
- [NOTIFICATIONS.md](./reference/NOTIFICATIONS.md) - Real-time notification system (Slack, Telegram, Email, Discord)
|
|
43
|
-
|
|
44
|
-
**When to read:** Implementing specific features, configuring advanced options, or troubleshooting.
|
|
45
|
-
|
|
46
|
-
### `/archive` - Historical Documentation
|
|
47
|
-
|
|
48
|
-
Legacy documentation preserved for reference:
|
|
49
|
-
|
|
50
|
-
- [CODE-REFERENCE-GUIDE.md](./archive/CODE-REFERENCE-GUIDE.md) - Legacy code navigation guide
|
|
51
|
-
- [PROJECT_SUMMARY.md](./archive/PROJECT_SUMMARY.md) - Original project summary (superseded by README)
|
|
52
|
-
- [NOTIFICATION-SYSTEM-SUMMARY.md](./archive/NOTIFICATION-SYSTEM-SUMMARY.md) - Notification implementation notes
|
|
53
|
-
- [UPPTIME_CONFIGURATION_COMPARISON.md](./archive/UPPTIME_CONFIGURATION_COMPARISON.md) - Upptime vs Stentorosaur comparison
|
|
54
|
-
|
|
55
|
-
**When to read:** Historical context, understanding legacy design decisions, or migration reference.
|
|
56
|
-
|
|
57
|
-
## Documentation by Use Case
|
|
58
|
-
|
|
59
|
-
### I want to...
|
|
60
|
-
|
|
61
|
-
**Get started quickly**
|
|
62
|
-
→ [QUICKSTART.md](../QUICKSTART.md)
|
|
63
|
-
|
|
64
|
-
**Understand what the plugin does**
|
|
65
|
-
→ [README.md](../README.md)
|
|
66
|
-
|
|
67
|
-
**Configure all available options**
|
|
68
|
-
→ [docs/reference/CONFIGURATION.md](./reference/CONFIGURATION.md)
|
|
69
|
-
|
|
70
|
-
**Set up automated monitoring**
|
|
71
|
-
→ [docs/reference/MONITORING_SYSTEM.md](./reference/MONITORING_SYSTEM.md)
|
|
72
|
-
|
|
73
|
-
**Add notification alerts**
|
|
74
|
-
→ [docs/reference/NOTIFICATIONS.md](./reference/NOTIFICATIONS.md)
|
|
75
|
-
|
|
76
|
-
**Deploy to production with GitHub Pages**
|
|
77
|
-
→ [README.md#github-actions-setup](../README.md#github-actions-setup)
|
|
78
|
-
|
|
79
|
-
**Use an orphaned branch for status data**
|
|
80
|
-
→ [docs/setup/ORPHANED_BRANCH_SETUP.md](./setup/ORPHANED_BRANCH_SETUP.md)
|
|
81
|
-
|
|
82
|
-
**Contribute to the project**
|
|
83
|
-
→ [CONTRIBUTING.md](../CONTRIBUTING.md)
|
|
84
|
-
|
|
85
|
-
**Understand the architecture**
|
|
86
|
-
→ [docs/architecture/ARCHITECTURE-INDEX.md](./architecture/ARCHITECTURE-INDEX.md)
|
|
87
|
-
|
|
88
|
-
**Write tests**
|
|
89
|
-
→ [docs/reference/TESTING.md](./reference/TESTING.md)
|
|
90
|
-
|
|
91
|
-
**Publish a new version**
|
|
92
|
-
→ [docs/setup/PUBLISHING.md](./setup/PUBLISHING.md)
|
|
93
|
-
|
|
94
|
-
## Maintenance
|
|
95
|
-
|
|
96
|
-
### Keeping Documentation Current
|
|
97
|
-
|
|
98
|
-
Documentation should be updated whenever:
|
|
99
|
-
- ✅ New features are added
|
|
100
|
-
- ✅ Configuration options change
|
|
101
|
-
- ✅ Workflows are modified
|
|
102
|
-
- ✅ Breaking changes occur
|
|
103
|
-
- ✅ Best practices evolve
|
|
104
|
-
|
|
105
|
-
See [CONTRIBUTING.md](../CONTRIBUTING.md) for guidelines on updating documentation.
|
|
106
|
-
|
|
107
|
-
### Documentation Standards
|
|
108
|
-
|
|
109
|
-
All documentation in this repository follows these standards:
|
|
110
|
-
|
|
111
|
-
1. **Markdown Format** - GitHub-flavored markdown
|
|
112
|
-
2. **Clear Headers** - Hierarchical structure with descriptive titles
|
|
113
|
-
3. **Code Examples** - Working examples for all features
|
|
114
|
-
4. **Cross-References** - Links to related documentation
|
|
115
|
-
5. **Version Context** - Note when features were added (e.g., "v0.5.0+")
|
|
116
|
-
6. **Current State** - Reflect the actual implementation, not future plans
|
|
117
|
-
|
|
118
|
-
## Need Help?
|
|
119
|
-
|
|
120
|
-
- **Issues**: [GitHub Issues](https://github.com/amiable-dev/docusaurus-plugin-stentorosaur/issues)
|
|
121
|
-
- **Discussions**: [GitHub Discussions](https://github.com/amiable-dev/docusaurus-plugin-stentorosaur/discussions)
|
|
122
|
-
- **Support**: See [SUPPORT.md](../SUPPORT.md)
|