-
Notifications
You must be signed in to change notification settings - Fork 303
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open questions around additional packages #138
Comments
(this is not a 1.0.0 blocker) |
I have found it both convenient and cumbersome to manage multiple packages in one place. For this set of packages, I see value in having them documented all at once. As for releases, we just use tag names like |
We can still do that if we separate the repositories with some sphinx magic. Also, intersphinx is pretty powerful, and the documentation around The tag stuff sounds reasonable, but I'm wondering if it's just more reasonable to have a separate repo. We could also just have a |
I don't actually have a preference, though ISTM the most cogent argument for "one repo" is to have a single issue tracker. |
Ah, I'm seeing that as an argument against one repo. I don't necessarily think I want issues related to httplib2 and oauthlib integration in this repo. @lukesneeringer any thoughts? |
I really (really, really, really) dislike the one-repository situation in google-cloud-python:
There are a few other reasons. My general advice is, "1:1 repos:packages". I wish I could change this on google-cloud-python (it would be an insane amount of work so I am hoping my CI changes are "good enough"). |
Cool, looks like it's settled. I'll make separate repos. :) |
👍 |
#137 introduced our second additional package. This raises some questions.
I think there is value in keeping these packages in this repository, but I can see argument for separating them into their own repositories. This would allow separate CI and simplify the release process for these libraries.
If we keep them here, should we roll-up their documentation into a special section in the google-auth documentation?
If the packages stay here, how should we handle releases?
@dhermes I'd really like your input here, as you tackled a similar set of problems with google-cloud-python.
The text was updated successfully, but these errors were encountered: