extract updated docs gen script from gloo

gloo lead the migration to the new docs format
some scripts/utils were made along the way, extract them here

some notes shared with @ilackarms while he introduced the second project to this format
https://github.com/solo-io/gloo/tree/generalize-docs-example-do-not-merge