doc command about ksonnet-lib HOT 6 OPEN

This idea looks interesting. I'm going to take a couple of days to play around with it and see what comes out.

from ksonnet-lib.

I have a preview of what ksonnet-lib documentation could look like up at http://g.bryan.dev.hepti.center.

from ksonnet-lib.

Just a ping as I'm also finding it hard to write more complex ksonnet lib files where I need to understand the mixins and other method available.

from ksonnet-lib.

@bryanl That looks pretty awesome! It's much nicer to read than the raw jsonnet.

I noticed a couple things.

1. When you jump to each group the name of that group is cut off. Probably from the "ksonnet API Documentation" header taking up a few pixels ontop of the name.
2. I might change the (chevron?) icon here. I initially thought I could expand that. ¶ maybe?

http://g.bryan.dev.hepti.center/core/v1/binding/#core.v1.binding.metadata

from ksonnet-lib.

@adamdecaf this site is not the final layout. The experiment was to see if suitable documentation could be generated from k8s.libsonnet. It helped expose a few gaps which we can hopefully share with the k8s docs team to help improve downstream efforts. Thanks for taking a look and I will work on getting those fixes in there to make it easier to read.

from ksonnet-lib.

Hi there!

Is there any progress on this?

Using ksonnet / ksonnet-lib without documentation and with essentially no code completion (the vscode extension is meant to be used for ksonnet as a whole, not ksonnet-lib specifically - and completion freezes often) is hard, and is making several of our developers upset.

from ksonnet-lib.