You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@apisix.apache.org by GitBox <gi...@apache.org> on 2022/02/24 12:00:02 UTC
[GitHub] [apisix] nfrankel commented on pull request #6415: docs: refactor the docs associated with Logger
nfrankel commented on pull request #6415:
URL: https://github.com/apache/apisix/pull/6415#issuecomment-1049787478
While it makes sense to "factor" common documentation snippets when you're a developer, I think it has a negative impact on the user-experience: people will need to navigate between 2 pages to have a global overview of a plugin configuration.
It stands to reason to have the reference documentation of a specific plugin "self-contained".
**Alternatives:**
1. Keep as it is. Pro: less maintenance effort, con: degraded developer experience
2. Duplicate common parameters in each plugin manually. Pro: good DX. Con: risk of mismatch
3. Duplicate common parameters in each plugin in an automated way. Markdown doesn't do it natively, we will probably need some scripts. On the other hand, [AsciiDoctor](https://asciidoctor.org/) does, but we will have to migrate the whole documentation.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org