elastic / elastic/integrations

Add documentation links to advanced option descriptions

Open
#4,739 3 comments 0 reactions 0 assignees View on GitHub
documentation enhancement Integration:fortinet_fortigate Team:Security-Deployment and Devices
Dominant language
Handlebars
Stars
333
Forks
647
Avg merge
2d 18h
Merged PRs (30d)
182

Description

Many of our integrations include configuration options to provide advanced settings for TCP, UDP inputs, SSL, etc. These are free-form fields and the user will need to know ahead of time what to provide. We should provide a link to the corresponding documentation that describes what fields may be provided. A few of our integrations already do this (PANW, for example), but many others are missing this documentation (Fortigate, for example).

Example of Custom TCP Options lacking a documentation link (Fortigate):
![Screen Shot 2022-11-30 at 8 12 05 AM](https://user-images.githubusercontent.com/90622908/204823456-f5a6f7fb-d232-41d6-949d-056b89e93014.png)

Example of Custom TCP Options with a documentation link (PANW):
![Screen Shot 2022-11-30 at 8 27 56 AM](https://user-images.githubusercontent.com/90622908/204823580-e200af1b-c4de-428d-b098-4a8c642caa4e.png)

This issue should apply to all integrations that allow providing custom options for inputs or other configuration areas. This includes, but is not limited to:
- Custom TCP Options (Usually found on TCP inputs)
- Custom UDP Options (Usually found on UDP inputs)
- SSL Options (Usually found on TCP inputs, but may be used elsewhere)

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.