Thankyou for the review @ndeloof! Let me know if you need any other changes

This PR should be done in the https://github.com/compose-spec/compose-go repository, no?
The version of the compose-spec.json file in this repo is just a copy of the compose-go one

This PR should be done in the https://github.com/compose-spec/compose-go repository, no? The version of the compose-spec.json file in this repo is just a copy of the compose-go one

If that is the case then we should add a README.md in the schema folder to educate users about this. I don't think this is clear to people looking at this repository unless they start looking at the code.

Improved schema documentation by adding descriptive text to various properties in the JSON schema.

This enhances DX by providing clear explanations of what each property does without requiring users to constantly refer to external documentation.

These changes address issue #138.

The descriptions come from sane descriptions found in https://github.com/microsoft/compose-language-service/blob/7a74283ddb866988fed86241f461a657f0aee6d0/src/service/providers/KeyHoverProvider.ts#L63-L184

Thanks for taking a look @glours! I've applied the same changes in the PR for the compose-go repo you mentioned here. I'll close this PR and let's continue the review there