Project

General

Profile

Actions

Documentation #6071

open

eve/schema: add descriptions to the schema

Added by Victor Julien 4 months ago. Updated 4 months ago.

Status:
New
Priority:
Normal
Assignee:
Target version:
Affected Versions:
Effort:
Difficulty:
Label:

Description

Goal is to use this to add to the auto generated documentation.

We'd need tooling to extract from schema, generate something we can include/reference from rtd.

More information on adding documentation can be found here: https://json-schema.org/understanding-json-schema/reference/generic.html

In most cases for us, this just means adding a "description" field. This is often best done by the person who knows an app-layer the best.

Example in our code: https://github.com/OISF/suricata/blob/master/etc/schema.json#L1135 (dns.opcode)


Subtasks 7 (7 open0 closed)

Documentation #6072: eve/schema: document smbNewVictor JulienActions
Documentation #6073: eve/schema: document dnsNewJason IshActions
Documentation #6074: eve/schema: document nfsNewVictor JulienActions
Documentation #6075: eve/schema: document httpNewPhilippe AntoineActions
Documentation #6076: eve/schema: document quicIn ReviewPhilippe AntoineActions
Documentation #6077: eve/schema: document sipNewJason IshActions
Documentation #6078: eve/schema: document pgsqlNewJuliana Fajardini ReichowActions

Related issues 1 (1 open0 closed)

Related to Suricata - Documentation #6288: eve/schema: generate tables of data for app-layer protocolsIn ProgressJason IshActions
Actions #1

Updated by Jason Ish 4 months ago

  • Subtask #6072 added
Actions #2

Updated by Jason Ish 4 months ago

  • Subtask #6073 added
Actions #3

Updated by Jason Ish 4 months ago

  • Subtask #6074 added
Actions #4

Updated by Jason Ish 4 months ago

  • Subtask #6075 added
Actions #5

Updated by Jason Ish 4 months ago

  • Subtask #6076 added
Actions #6

Updated by Jason Ish 4 months ago

  • Subtask #6077 added
Actions #7

Updated by Jason Ish 4 months ago

  • Subtask #6078 added
Actions #8

Updated by Jason Ish 4 months ago

  • Description updated (diff)
Actions #9

Updated by Jason Ish 25 days ago

  • Related to Documentation #6288: eve/schema: generate tables of data for app-layer protocols added
Actions

Also available in: Atom PDF