Skip to content

docs(schema): #13 - improve json property descriptions#17

Open
jeanbaptisterevel wants to merge 1 commit into
Djaytan:mainfrom
jeanbaptisterevel:docs/improve-json-property-descriptions
Open

docs(schema): #13 - improve json property descriptions#17
jeanbaptisterevel wants to merge 1 commit into
Djaytan:mainfrom
jeanbaptisterevel:docs/improve-json-property-descriptions

Conversation

@jeanbaptisterevel
Copy link
Copy Markdown
Contributor

@jeanbaptisterevel jeanbaptisterevel commented Jul 8, 2025

Improve descriptions of properties in the json schema.

I'm not sure this is exactly what you asked for, I'm having a hard time making these descriptions more accurate...

Closes #13

@jeanbaptisterevel jeanbaptisterevel force-pushed the docs/improve-json-property-descriptions branch 2 times, most recently from 521094d to 1e575f7 Compare July 13, 2025 15:57
Comment thread src/values.schema.json Outdated
"resources": {
"type": "object",
"description": "Resource requests and limits.",
"description": "Kubernetes resource constraints for the container, used to control CPU, memory, and ephemeral storage usage. See: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/#resource-units-in-kubernetes",
Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ends with dot even if the last element is an URL.

Comment thread src/values.schema.json Outdated
},
"memory": {
"type": "string",
"description": "Maximum amount of memory requested (e.g., '8Gi').See: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/#resource-units-in-kubernetes"
Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

).See: -> ). See:

Comment thread src/values.schema.json Outdated
"memory": { "type": "string" }
"ephemeralStorage": {
"type": "string",
"description": "Maximum amount of ephemeral (temporary) storage requested (e.g., '10Gi').See: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/#resource-units-in-kubernetes"
Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

).See: -> ). See:

@jeanbaptisterevel jeanbaptisterevel force-pushed the docs/improve-json-property-descriptions branch from 1e575f7 to 80f68df Compare July 16, 2025 20:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

JSON Schema - Systematic description of properties

2 participants