{"action":"opened","issue":{"url":"https://api.github.com/repos/GoogleCloudPlatform/gcloud-common/issues/52","labels_url":"https://api.github.com/repos/GoogleCloudPlatform/gcloud-common/issues/52/labels{/name}","comments_url":"https://api.github.com/repos/GoogleCloudPlatform/gcloud-common/issues/52/comments","events_url":"https://api.github.com/repos/GoogleCloudPlatform/gcloud-common/issues/52/events","html_url":"https://github.com/GoogleCloudPlatform/gcloud-common/issues/52","id":127765055,"number":52,"title":"docs: individual module version management","user":{"login":"callmehiphop","id":1707267,"avatar_url":"https://avatars.githubusercontent.com/u/1707267?v=3","gravatar_id":"","url":"https://api.github.com/users/callmehiphop","html_url":"https://github.com/callmehiphop","followers_url":"https://api.github.com/users/callmehiphop/followers","following_url":"https://api.github.com/users/callmehiphop/following{/other_user}","gists_url":"https://api.github.com/users/callmehiphop/gists{/gist_id}","starred_url":"https://api.github.com/users/callmehiphop/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/callmehiphop/subscriptions","organizations_url":"https://api.github.com/users/callmehiphop/orgs","repos_url":"https://api.github.com/users/callmehiphop/repos","events_url":"https://api.github.com/users/callmehiphop/events{/privacy}","received_events_url":"https://api.github.com/users/callmehiphop/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2016-01-20T19:29:14Z","updated_at":"2016-01-20T19:29:14Z","closed_at":null,"body":"It seems like there's been a bit of chatter about some libraries moving toward individual modules instead of a single giant module. @blowmage [made a good point](https://github.com/GoogleCloudPlatform/gcloud-common/issues/49#issuecomment-173008535) about how versioning the individual modules will complicate the docs app.\r\n\r\nThe simplest way to solve that problem (that I can think of) might be to include a menu that simply allows one to switch between the main gcloud module and all individual modules. I put together a quick comp to illustrate the idea (forgive me if it's hideous).\r\n\r\n![default-state](https://cloud.githubusercontent.com/assets/1707267/12460380/6b3884e6-bf81-11e5-9350-098a13d1ca36.jpg)\r\n![expanded-state](https://cloud.githubusercontent.com/assets/1707267/12460387/71606cc6-bf81-11e5-914a-c4679e081df3.jpg)\r\n\r\nSwitching modules could repopulate the version dropdown to only contain the available versions for the selected module. The API section would probably only be populated with relating pages, for example, when selecting gcloud-bigquery, only Dataset, Job and Table would be listed.\r\n\r\nThoughts?\r\n\r\n"}}