Skip to content

[Feedback]: Poor visual contrast makes API docs difficult to read #245

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
rseldner opened this issue Dec 17, 2024 · 2 comments
Open

[Feedback]: Poor visual contrast makes API docs difficult to read #245

rseldner opened this issue Dec 17, 2024 · 2 comments
Labels
api-feedback documentation Improvements or additions to documentation Team:Platform Issues owned by the Platform Docs Team

Comments

@rseldner
Copy link
Contributor

Was the documentation helpful?

Yes

What documentation page is affected

https://www.elastic.co/docs/api/doc/kibana/v8

Description

I find the API doc pages difficult to read. The visual elements feel too 'soft'; there's not enough contrast or clear separation between sections. This causes everything to sort of blend together, making it hard to quickly identify headings and content. Stronger visual cues would improve readability.

Current Proposed
Image Image
@rseldner rseldner added api-feedback documentation Improvements or additions to documentation labels Dec 17, 2024
@ecs-chrisg
Copy link

Agree with @rseldner, I find myself squinting at the new docs

@bmorelli25 bmorelli25 added needs-team Issues pending triage by the Docs Team Team:Platform Issues owned by the Platform Docs Team labels Apr 17, 2025
@github-actions github-actions bot removed the needs-team Issues pending triage by the Docs Team label Apr 17, 2025
@georgewallace
Copy link
Contributor

@rseldner Thank you for the feedback. We will provide this feedback to bump who hosts our API documentation.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
api-feedback documentation Improvements or additions to documentation Team:Platform Issues owned by the Platform Docs Team
Projects
None yet
Development

No branches or pull requests

4 participants