René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Find a way to share the HTML + CSS for our gcloud-* docs ?","articleBody":"From @dhermes in https://github.com/GoogleCloudPlatform/gcloud-python/pull/1092#issuecomment-135033490:\n\n\u003e @jgeewax I think we should tried to have shared HTML / JS / CSS for our custom theme.\n\u003e \n\u003e It seems the Node.js theme continues to improve while ours looks like an old snapshot of what they had.\n\u003e \n\u003e Comparing our custom docs to RTD is not great (i.e. ours look not so great):\n\u003e http://googlecloudplatform.github.io/gcloud-python/latest/gcloud-auth.html\n\u003e http://gcloud-python.readthedocs.org/en/latest/gcloud-auth.html\n\u003e \n\u003e UPDATE: I think we should consider just using readthedocs and maybe customizing their theme.\n\n---\n## Sharing themes:\n\nI think if we can find a way to generate a JSON output of our docs like the `dox` script does, we could use the exact same theme. I would really really like that.\n\n/cc @stephenplusplus @callmehiphop to comment\n## Just using read-the-docs:\n\nI totally get that this is \"the Python way to host docs\" -- I'm all for it _in addition_ to the gcloud themed docs, the same way I'm all for Javadocs for gcloud-java and Godocs for gcloud-golang (and MSDN looking docs for gcloud-dotnet when we do it). The branding piece is important as well, and I'm fine with us investing the time to continue maintaining these.\n\nAm I correct in the assumption that RTD / Javadocs / etc should take relatively small amounts of work going forward?\n","author":{"url":"https://github.com/jgeewax","@type":"Person","name":"jgeewax"},"datePublished":"2015-08-26T14:23:40.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":37},"url":"https://github.com/1094/google-cloud-python/issues/1094"}