-
Notifications
You must be signed in to change notification settings - Fork 3.5k
Closed
Labels
Description
Related:
- Support for Logstash plugins (WIP) docs-builder#211
- Long term for Logstash documentation docs-builder#366
- Doc: Create plan to convert plugin docs source and output from ASCIIDOC to MD (and update tooling) #16852
- Doc: Items to check and complete post-migration #16985
Possible path forward
Phase 1: Initial migration
- Most Logstash content is included in new docs IA under Reference.
- Content migrated and added back to the
logstashrepo
- Content migrated and added back to the
- Shared (or referenced) content migrated and added to the
docs-contentrepo.- Troubleshooting
- install
- Upgrade
- Breaking changes
- Release notes
- ToDo: @karenzone to spotcheck output for anomalies
Phase 2 - Implement post-docgen content migration from ADOC->MD
- Content generated by Logstash docs tools lands in
logstash-docsrepo now.
Phase Next: Scope moving plugin asciidoc source and tooling support to MD
- Logstash plugin docs tooling
- ADOC->MD conversion plan for Logstash plugin source
- Initial proposal:
- Convert Tier 1 (Elastic) plugins first
- Convert plugins that have frequent updates next
- Plan and convert lesser used plugins. (Do we want to convert them all?)
- Initial proposal: