Hoist enum values from subschemas

[nightkr]

Fixes #1047

Currently this drops variant-level documentation, do we want to include it in the enum property's documentation instead?

[jpmcb]

👏🏼 Used this patch off of my code mentioned in #1047 and it solves my usecase - thanks!

[kazk]

Currently this drops variant-level documentation, do we want to include it in the enum property's documentation instead?

Do you mean something like this?

"description": "Gender of the person\n\nOther - This variant has a comment!"

I think it's better to keep the current version because users can still add variant-level documentation manually if they'd like. Automatically including them will be a nice opt-in feature, though.

[nightkr]

Yeah, basically.

[codecov-commenter]

Codecov Report

Merging #1051 (9dd40ab) into main (9d1a554) will increase coverage by 0.07%.
The diff coverage is 96.42%.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1051      +/-   ##
==========================================
+ Coverage   72.24%   72.32%   +0.07%     
==========================================
  Files          65       65              
  Lines        4687     4704      +17     
==========================================
+ Hits         3386     3402      +16     
- Misses       1301     1302       +1     

Impacted Files	Coverage Δ
kube-core/src/schema.rs	89.70% <95.83%> (+1.47%)	⬆️
kube-derive/tests/crd_schema_test.rs	100.00% <100.00%> (ø)