Skip to content

[Feedback]: return old api docs, i can not read this api docs, no one normal examples with params #1279

@Ada-lave

Description

@Ada-lave

Was the documentation helpful?

Yes

What documentation page is affected

return old api docs, i can not read this api docs, no one normal examples with params

Description

return old api docs, i can not read this api docs, no one normal examples with params

Activity

san3Xian

san3Xian commented on Apr 28, 2025

@san3Xian

The new version of the documentation lacks a lot of explanations regarding the parameters compared to the old version, and it also lacks many examples of different parameters.

georgewallace

georgewallace commented on Jul 2, 2025

@georgewallace
Contributor

@Ada-lave and @san3Xian Apologize for the delay in getting back to this issue. Can you give me some examples where there is missing information? We are working hard to bring many improvements to our new API docs. The new API docs are generated directly from our OpenAPI spec so they should be accurate and up to date. This does reduce the ability to have as much narrative content in-line though which I understand can be frustrating. The team has been working on ensuring that all the old verbose and narrative content is brought into the API content either directly or we are ensuring core links back to the documentation with the old examples. If you have specific examples though this will help us greatly.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

      Development

      No branches or pull requests

        Participants

        @georgewallace@szabosteve@san3Xian@Ada-lave

        Issue actions

          [Feedback]: return old api docs, i can not read this api docs, no one normal examples with params · Issue #1279 · elastic/docs-content