[Feedback][API reference] New UI is over complicated

[tahir-spidersilk]

The old docs layout was completely ok, the pages were to the point and request examples were laid out in increasing order of parameters.
The new UI is too complicated, overly dense and it's hard to find what I'm looking for. Unnecessarily revised IMO.

[georgewallace]

@tahir-spidersilk Thank you for raising this feedback. We are working on numerous improvements to make our API documentation better. Your feedback here is very valuable to improving th experience.

When you say it is hard to find what you are looking for is this through search or just navigating the site?

What is your primary way of searching for a specific API?

[tahir-spidersilk]

@georgewallace The use case that I follow:

• Search for a specific function in ES on google
• Open the docs from the result
• Scroll through the page and see the highlights and request examples at a glance
• Navigate to the bottom to find all the request parameters and their details.

Now there is no clear boundary between the current function that I am investigating and I overflow to the next.
Also, often times I just want to see the code examples only and that fulfills my need for the docs.

Lastly, the previous layout was comfortable, all headings and titles had a distinct look that would help in skimming through and finding things fast, the new one is just monochromatic and all out there.