elastic / elastic/stack-docs

[Docs] modify CSS to show "parser options" in italic in the Elastic Docs, similar to Github

Open
#2,263 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Java
Stars
105
Forks
249
PR merge metrics
No merged PRs in 30d

Description

In our documentation in Github at https://github.com/elastic/beats/blob/8.5/filebeat/docs/inputs/input-filestream-reader-options.asciidoc#ndjson. we can see that the parser (e.g., `ndjson`) is formatted in a **bold mono** font.

The parser options (e.g., `target`) are formatted as a **_bold italic mono_** font.

This makes it easy to distinguish between the Parser and the Parser options.

Looking at the resulting document in our docs at https://www.elastic.co/guide/en/beats/filebeat/current/filebeat-input-filestream.html#_ndjson, we can see that the Parser and the Parser Options have the same formatting. They are both bold mono font with the parser options missing the italic formatting.

This makes it harder to read the official document compared to the GitHub document. A customer complained and asked if we can make the Parser Options in our doc italic, too, for easy readability.

GitHub (good formatting):
![2022-11-14 13_49_48-github](https://user-images.githubusercontent.com/55087308/201930442-71a31585-160c-439f-bc6e-ad377342759d.png)

Elastic Docs (bad formatting):
![2022-11-14 13_47_58-Program Manager](https://user-images.githubusercontent.com/55087308/201930406-d7386c88-6f96-4092-8fcd-598aaaf06bd3.png)

Originally filed at https://github.com/elastic/website-requests/issues/840

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.