kibana/dev_docs/contributing
Christiane (Tina) Heiligers 94b1174254
Adds guidelines for designing HTTP APIs (#224348)
This PR adds guidelines for designing Kibana HTTP APIs that are
terraform-provider developer friendly.
fix https://github.com/elastic/kibana/issues/224643

## Summary
Kibana doesn't have specific guidelines for designing HTTP APIs. With
increasing constraints, it's time to document what was previously tribal
knowledge.

Elasticsearch is far further along this road, and other teams have
compiled their own.
This document serves as guidelines to designing _public_ HTTP APIs that
are suitable for managing with Terraform.

## How to test this (recommended for easier reading)
- pull this PR
- setup
[`docs.elastic.dev`](https://docs.elastic.dev/docs/local-dev-docs-setup)
locally
- run `yarn dev` from `docs.elastic.dev`
- review the docs live!

![Screenshot 2025-06-19 at 14 58
48](https://github.com/user-attachments/assets/bda09e04-8351-4f78-b8df-ebfd7b248903)


### Checklist

Check the PR satisfies following conditions. 

Reviewers should verify this PR satisfies this list as well.

- [x]
[Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html)
was added for features that require explanation or tutorials

---------

Co-authored-by: florent-leborgne <florent.leborgne@elastic.co>
Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
2025-06-24 08:01:06 -07:00
..
best_practices.mdx SKA: Update broken references and URLs (#206836) 2025-01-28 03:32:48 +00:00
code_walkthrough.mdx SKA: Extract list of Kibana solutions into a dedicated package (#213353) 2025-03-20 10:20:07 +01:00
dev_principles.mdx Add dependency docs (#194333) 2024-10-02 07:55:32 -04:00
documentation.mdx SKA: Update broken references and URLs (#206836) 2025-01-28 03:32:48 +00:00
how_we_use_github.mdx [ci] Remove duplicate backport action (#190643) 2024-08-20 08:23:25 -05:00
kibana_http_api_guidelines.mdx Adds guidelines for designing HTTP APIs (#224348) 2025-06-24 08:01:06 -07:00
standards.mdx Add dependency docs (#194333) 2024-10-02 07:55:32 -04:00
third_party_dependencies.mdx [Docs] Added dependency evaluation process (#216494) 2025-04-15 14:54:55 +02:00