Improve comments and schema

[dgageot]

Signed-off-by: David Gageot david@gageot.net

[codecov-io]

Codecov Report

❗ No coverage uploaded for pull request base (master@b9c979d). Click here to learn what that means.
The diff coverage is 95.27%.

@@            Coverage Diff            @@
##             master    #1652   +/-   ##
=========================================
  Coverage          ?   48.13%           
=========================================
  Files             ?      120           
  Lines             ?     5322           
  Branches          ?        0           
=========================================
  Hits              ?     2562           
  Misses            ?     2502           
  Partials          ?      258

Impacted Files	Coverage Δ
pkg/skaffold/jib/jib_gradle.go	100% <100%> (ø)
pkg/skaffold/jib/jib_maven.go	100% <100%> (ø)
schemas/main.go	87.19% <95.2%> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update b9c979d...22f3e28. Read the comment docs.

[balopat]

LGTM