Skip to content

Beta FAQ update #3346

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

Merged
merged 3 commits into from
Mar 26, 2018
Merged

Beta FAQ update #3346

merged 3 commits into from
Mar 26, 2018

Conversation

brainwane
Copy link
Contributor

@brainwane brainwane commented Mar 22, 2018

Marking as blocked since I know this depends on updating the banner in pypi-theme. I suggest #beta and beta() for the help/ section label, which would require the banner changing its link.

@ewdurbin @dstufft @nlhkabu @di I am a thousand percent open to critique on this FAQ change; what promises should we be making about infra & features? What should we encourage people to do or avoid?

Ref. #2518. (does not close entirely; we'll close it after we launch/redirect)

@brainwane brainwane added the blocked Issues we can't or shouldn't get to yet label Mar 22, 2018
@@ -45,7 +45,8 @@ Here are some tips.
* JSON API: ``https://pypi.org/pypi/{name}/json`` returns the
expected JSON response directly. See :doc:`json`.

* XML-RPC API: see :ref:`changes-to-legacy-api`.
* XML-RPC API: see :ref:`changes-to-legacy-api`. Will be deprecated in
the future; switch to the RSS or JSON APIs.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we call to action to file issues for things that they use that only exists in the XMLRPC API?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good call! Fixed.

</ul>
<p>
While we are in pre-production, our infrastructure cannot yet support all of the traffic generated by our users running <code>pip install</code>. We therefore ask that you do not use this version of PyPI for production codebases.
While we are in beta, the pypi.org infrastructure cannot yet support all of the API traffic generated by our users running <code>pip install</code>, so don't explicitly point to it in your production setups. But we're occasionally redirecting portions of that traffic in load tests we announce <a href="http://status.python.org/">on our status page</a>.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we can say we're generally ready for traffic? Or will be once @ewdurbin gets the XMLRPC caching sorted out? Are we ready to tell people they can start shifting their own traffic to Warehouse now? I'm not sure how to word it really, but like "Early Adopter" traffic is probably not going to knock us over?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd like to encourage early adopter traffic, and can find a way to word it if @ewdurbin says it's ok.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Once we get #3336 cleared up, we'll be all set to start calling it beta. Right now it's just too costly if a user with lots of projects logs in.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ewdurbin Good info, thanks. So, once we're in beta, what level of traffic are you ok with encouraging? (this is kind of "what does 'beta' mean to you?")

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Anything that arrives organically is probably fine. We may be migrating our backend database as well now... so perhaps we should wait until after that?

@brainwane brainwane force-pushed the beta-faq branch 2 times, most recently from f45a4b7 to 9a90be3 Compare March 22, 2018 14:19
@brainwane
Copy link
Contributor Author

Ready for re-review with new traffic wording.

@brainwane brainwane force-pushed the beta-faq branch 3 times, most recently from 747b51c to 082588d Compare March 23, 2018 01:00
@brainwane brainwane changed the title WIP Beta FAQ update Beta FAQ update Mar 26, 2018
@brainwane brainwane removed the blocked Issues we can't or shouldn't get to yet label Mar 26, 2018
@brainwane brainwane merged commit 7743cee into master Mar 26, 2018
@brainwane brainwane deleted the beta-faq branch March 26, 2018 15:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants