elastic / elastic/docs-builder

Allowing nesting of variables

Open
#152 10 comments 0 reactions 0 assignees View on GitHub
ai-triaged ai:product-question ai:writer-question migration stale
Dominant language
C#
Stars
24
Forks
44
Avg merge
1d 7h
Merged PRs (30d)
146

Description

Today the `asciidoc` system allows nesting of variables e.g:

```
:es: Elasticsearch
:es-sql: {es} SQL

:webhook: Webhook
:webhook-cm: {webhook} - Case Management

:ml: machine learning
:ml-jobs: {ml} jobs

:es-repo: https://github.com/elastic/elasticsearch/
:es-issue: {es-repo}issues/
:es-pull: {es-repo}pull/
:es-commit: {es-repo}commit/
```

While ideally we don't take on this complexity it does seem very pervasively used.

Should we implement this or force a more simple `key : value` on to our writers and developers?

@bmorelli25 @KOTungseth @reakaleek

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.