Revised API reference documentation

[Tim Bannister]

Hi

I'd like to discuss the revised API reference with SIG Architecture.

You can see a preview at https://k8s.io/docs/reference/kubernetes-api/, and there's an issue to track making this the main reference. The preview that's there is currently blocked from crawlers using robots.txt.

@liggitt already provided good feedback; I want to understand what minimum steps are needed before we can allow crawlers at it and start deprecating the existing page (example). Specifically, I'm OK with merging something that isn't perfect, so long as we aren't making it difficult to fix those imperfections.

Also, are there any other details we should discuss or track?

Tim

[Davanum Srinivas]

Tim,

Sorry, had forgotten to respond to this! So looks like the crux is about the stability of the urls as you mentioned here:

https://github.com/kubernetes/website/issues/25505#issuecomment-779347364

I really like how Jordan has laid out in:

https://github.com/kubernetes/website/issues/25505#issuecomment-763656285

Can we please line this up for the next sig-arch call? 

thanks,

Dims

--
You received this message because you are subscribed to the Google Groups "kubernetes-sig-architecture" group.
To unsubscribe from this group and stop receiving emails from it, send an email to kubernetes-sig-arch...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/kubernetes-sig-architecture/16204dae-e289-4159-95ec-587515d306f5n%40googlegroups.com.