knative / knative/hack

schema tool does not pull the top level comment on the resource.

Open
#56 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Shell
Stars
26
Forks
70
PR merge metrics
No merged PRs in 30d

Description

This one:

```
openAPIV3Schema: &openAPIV3Schema
description: 'some comment on the toplevel struct'
type: object
....
```

Contributor guide

Open the contributing guide

Research direction

Locate the schema tool that processes the shown openAPIV3Schema resource and trace how its top-level description is handled. Reproduce the case from the issue, then verify that the generated result retains the comment on the top-level resource.

Written by the indexing model from the issue text.

Assessment

Tech stack
openapi
Domain
tooling
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.