@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/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)