jupyterhub / mybinder.org-user-guide

Turn a Git repo into a collection of interactive notebooks. This is Binder's user documentation repository.
https://mybinder.readthedocs.io
BSD 3-Clause "New" or "Revised" License
153 stars 103 forks source link

Binder 2.0 announcement blog posts #22

Closed choldgraf closed 6 years ago

choldgraf commented 6 years ago

A place to discuss the Binder 2.0 blog post, currently planned for publishing on the eLife blog. eLife has slots open for a blog post on November 9th, as well as a few dates at the end of November.

Links

Binder blog post hackmd in case we want to iterate there. As the Jupyter blog post was in docs, I figure this will be an easier platform for people to leave comments, edits, etc. We can transfer to hackmd if that's what people prefer.

Other notes

thoughts from naomi on the eLife topic:

From my perspective, it would be great to tell the story of how the team picked up Binder, why it needed further work, what you have done, and how readers can act on this info - e.g. try it out, contribute. The aim is to spread the word about Binder to life scientists, so this blogpost could act as a news piece, with links to your own blogs for further detail. However, technical details are also very welcome.

Carreau commented 6 years ago

Thanks !

choldgraf commented 6 years ago

ughhh we can't copy/paste from the google doc and get all the links to work etc in Medium. Will work on this now but it'll take half an hour or so

Carreau commented 6 years ago

ughhh we can't copy/paste from the google doc and get all the links to work etc in Medium. Will work on this now but it'll take half an hour or so

Yeah, that's a pain. I was unsure. I think if you can "expot to html" and host it somewhere you can "import it" into medium and links works.

choldgraf commented 6 years ago

woot! that was a great idea @Carreau ... turns out this works for raw github content too :-) https://raw.githubusercontent.com/choldgraf/sandbox/master/blog_postbinder_2_jupyter.html

choldgraf commented 6 years ago

ok all, I think I have the binder tech guide ready to go here:

https://medium.com/@choldgraf/binder-tech-2017-fd40515a3a84

@Carreau when I hit "add to publication" I don't see anything in there...

choldgraf commented 6 years ago

I'm a bit concerned that it's heavy on text and short on images. What do you all think about adding one image showing the Binder landing page mid-build, and another showing an RStudio or JupyterLab interface

ellisonbg commented 6 years ago

+1

On Wed, Nov 29, 2017 at 11:06 AM, Chris Holdgraf notifications@github.com wrote:

I'm a bit concerned that it's heavy on text and short on images. What do you all think about adding one image showing the Binder landing page mid-build, and another showing an RStudio or JupyterLab interface

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/jupyterhub/binder/issues/22#issuecomment-347945747, or mute the thread https://github.com/notifications/unsubscribe-auth/AABr0PuZS0MC5S3WrDINe6WRUSj_Y91Iks5s7Z0qgaJpZM4P50pr .

-- Brian E. Granger Associate Professor of Physics and Data Science Cal Poly State University, San Luis Obispo @ellisonbg on Twitter and GitHub bgranger@calpoly.edu and ellisonbg@gmail.com

choldgraf commented 6 years ago

uhhhh, when I tried building a lab repository, I got a really weird result:

image

this happens on chrome, firefox, an incognito tab, and another person's computer. It's running lab 0.28

@ellisonbg have you seen anything like this before?

choldgraf commented 6 years ago

this doesn't happen on a different repo:

mybinder.org/v2/gh/binder-examples/requirements/master?urlpath=lab

but it does happen on the jupyterlab demo repo:

mybinder.org/v2/gh/binder-examples/jupyterlab/master?urlpath=lab

ellisonbg commented 6 years ago

No, can you post to the JupyterLab gitter channel?

On Wed, Nov 29, 2017 at 11:19 AM, Chris Holdgraf notifications@github.com wrote:

uhhhh, when I tried building a lab repository, I got a really weird result:

[image: image] https://user-images.githubusercontent.com/1839645/33391704-ac5d5d46-d4ee-11e7-8dfd-8ec30fac2f1f.png

this happens on chrome, firefox, an incognito tab, and another person's computer. It's running lab 0.28

@ellisonbg https://github.com/ellisonbg have you seen anything like this before?

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/jupyterhub/binder/issues/22#issuecomment-347949230, or mute the thread https://github.com/notifications/unsubscribe-auth/AABr0MUvFGFdLVU5stSCRgm0E7oU_M0rks5s7aAUgaJpZM4P50pr .

-- Brian E. Granger Associate Professor of Physics and Data Science Cal Poly State University, San Luis Obispo @ellisonbg on Twitter and GitHub bgranger@calpoly.edu and ellisonbg@gmail.com

ellisonbg commented 6 years ago

I tested it on my altair_viz/altair_notebooks repos and it works fine. Try in an incognito window?

Might be an issue with that version - JupyterLab is at 0.29 now

On Wed, Nov 29, 2017 at 11:20 AM, Chris Holdgraf notifications@github.com wrote:

this doesn't happen on a different repo:

mybinder.org/v2/gh/binder-examples/requirements/master?urlpath=lab

but it does happen on the jupyterlab demo repo:

mybinder.org/v2/gh/binder-examples/jupyterlab/master?urlpath=lab

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/jupyterhub/binder/issues/22#issuecomment-347949599, or mute the thread https://github.com/notifications/unsubscribe-auth/AABr0JnbWYw1AN8X8v7Li4vxylzoUVrtks5s7aBjgaJpZM4P50pr .

-- Brian E. Granger Associate Professor of Physics and Data Science Cal Poly State University, San Luis Obispo @ellisonbg on Twitter and GitHub bgranger@calpoly.edu and ellisonbg@gmail.com

choldgraf commented 6 years ago

I tried rebuilding and that magically fixed it, so I think we're good...must have been an intermediate bug in there in the previous version of the build.

choldgraf commented 6 years ago

(thx to @ian-r-rose for coming over to help!)

Carreau commented 6 years ago

@Carreau when I hit "add to publication" I don't see anything in there...

Retry, you were not a Jupyter editor.

Carreau commented 6 years ago

Almost all the links are messed up and redirect to google, that redirect one more time. I can help you fix that once you've actually submited the draft to Jupyter – we can coordinate to know who is editing the file, or I'll do it tomorrow morning when you are asleep :-)

choldgraf commented 6 years ago

just submitted it to Jupyter's blog. Yeah that's super annoying about the links :-/

Just a note that (I think) the elife post is going up around 4pm your time on Thursday, so we should coordinate this post accordingly

On Wed, Nov 29, 2017 at 11:07 AM Matthias Bussonnier < notifications@github.com> wrote:

Almost all the links are messed up and redirect to google, that redirect one more time. I can help you fix that once you've actually submited the draft to Jupyter – we can coordinate to know who is editing the file, or I'll do it tomorrow morning when you are asleep :-)

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/jupyterhub/binder/issues/22#issuecomment-347963439, or mute the thread https://github.com/notifications/unsubscribe-auth/ABwSHd8MRbPuYZCfBU-nWGgKhpc4Qqpkks5s7at4gaJpZM4P50pr .

Carreau commented 6 years ago

just submitted it to Jupyter's blog. Yeah that's super annoying about the links :-/

I'm going to add "To fix" to all of those who need fixing, so we can just an do 5 or 6, and just dismiss the comment saying they need fixing. I already did a few.

willingc commented 6 years ago

There are a few typos in the draft. If someone has time to edit, that would be great. I can look at it tonight if not.

choldgraf commented 6 years ago

I'll for sure take a copy editing pass later today, but more eyeballs would definitely be appreciated :-)

On Wed, Nov 29, 2017, 11:45 AM Carol Willing notifications@github.com wrote:

There are a few typos in the draft. If someone has time to edit, that would be great. I can look at it tonight if not.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/jupyterhub/binder/issues/22#issuecomment-347974314, or mute the thread https://github.com/notifications/unsubscribe-auth/ABwSHaSx1-tKZtmz6fDx4ac7TM2fGQsaks5s7bRNgaJpZM4P50pr .

choldgraf commented 6 years ago

@Carreau I took a pass and got a bunch of them up to the last section, probably about a half dozen more to do

choldgraf commented 6 years ago

@willingc btw, were you talking about the jupyter blog draft or the elife draft? I believe elife has a copyeditor who's taken a pass at it. We don't have this for the jupyter blog post :-)

willingc commented 6 years ago

jupyter blog post @choldgraf

choldgraf commented 6 years ago

OK I fixed the remaining links. I will try to take a copy-editing pass this evening on the jupyter blog post. Need to spend a bit of time not looking at it first.

Regarding github topics, we are at a bit of an impasse. Shall with go with a single topic (e.g., binder) or mention multiple topics (binder and binder-ready). I lean towards single topic but want to make sure the team weighs in since this will be hard to reverse once people start using it.

willingc commented 6 years ago

As for topics, I don’t feel strongly about it. My concern with binder only is that it also covers other DNS projects and Django projects. 23 of the 54 repos currently tagged with binder are other projects. That said I could see our binder being most popular over time.

choldgraf commented 6 years ago

Definitely understand your point. I kinda feel like users are going to end up tagging their repositories with "binder" either way, no? A few had already done this and unless a user knows to make it "binder-ready" they probably wouldn't do it on their own. I think I am 60% towards binder and 40% binder-ready

betatim commented 6 years ago

My vote goes to binder and one topic only. I think the kinds of projects are different enough that as a human looking at the list you can tell what is DNS/Django and what is a repo that works with binder.

betatim commented 6 years ago

@Carreau @npscience I think all the posts are now in places where I can't easily edit them anymore. If you would like help with anything let me know. I will be around till about 4pm Paris time, after that I have some offline meetings for the rest of the evening.

Carreau commented 6 years ago

Seeing that (excluding our own repositories) there is more repository using binder (9+ I stopped counting cause GitHub list several dozen) topics than either mybinder (7) or binder-ready (7, and those are only ours), I'm in favor of doing only binder and will edit the article accordingly.

npscience commented 6 years ago

We're ready on eLife side. It's not live yet (4pm UK time) but the post will be at https://elifesciences.org/labs/8653a61d so you can add in the URL in your post.

Do you have a URL for the Jupyter post yet? Or does it change when published?

Carreau commented 6 years ago

Thanks ! Updated.

I think I found the final URL:

https://blog.jupyter.org/binder-2-0-a-tech-guide-2017-fd40515a3a84

We can still change up until publication. are you publishing at 4pm sharp ? I can setup medium to publish it at the exact same time as well.

yuvipanda commented 6 years ago

I made some minor corrections for technical accuracy (almost entirely just removing words or sentences) in the Jupyter blog post, and it looks all correct to me. Thanks to everyone for pulling this through!

willingc commented 6 years ago

Can we make one final edit to the Jupyter blog post text?

This is relatively straightforward by following the instructions on the BinderHub documentation, which are currently in an alpha state and undergoing improvements as the technology evolves.

Can we remove the part about "currently in an alpha state" and replace with "are currently under active development to meet ongoing improvements as the Kubernetes technology evolves"? I think that "alpha" very much understates the production quality of the system and docs.

For some reason, I can't access the editing of Medium on this document.

minrk commented 6 years ago

@willingc edit made. Investigating medium permissions, now.

minrk commented 6 years ago

I just ran through the linked binder and it's not working. The data source seems to have a problem because when I try to download the file, I get an SSL error trying to connect.

minrk commented 6 years ago

I've figured out that it's a problem with the SSL certificate for the bike data provider.

This PR: https://github.com/wildtreetech/explore-open-data/pull/13

Because the links refer to master of that repo, if that PR lands, everything should be okay.

cc @betatim

minrk commented 6 years ago

If that PR doesn't land, we can use minrk/explore-open-data/master

minrk commented 6 years ago

Fix has been deployed, everything is fine now! The links in the posts should work as-is. Move along...

npscience commented 6 years ago

@Carreau Thanks for the link! Indeed, I'll click the button just before 4pm. Our updates push through every 5 minutes, so it should be live soon after 4pm. Let's sync up?

minrk commented 6 years ago

I've scheduled the Jupyter post to go up at 17:00 CET (in ~20 minutes). That's right, yes? Timezones make me nervous.

ellisonbg commented 6 years ago

Cools, sounds like binder has it! Over time as there are more repos with this label other folks will likely stop using it...

On Thu, Nov 30, 2017 at 8:39 AM, Min RK notifications@github.com wrote:

I've scheduled the Jupyter post to go up at 17:00 CET (in ~20 minutes). That's right, yes? Timezones make me nervous.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/jupyterhub/binder/issues/22#issuecomment-348225763, or mute the thread https://github.com/notifications/unsubscribe-auth/AABr0BFZbgsglaFVbsH2D7_WQBVrRzpEks5s7swxgaJpZM4P50pr .

-- Brian E. Granger Associate Professor of Physics and Data Science Cal Poly State University, San Luis Obispo @ellisonbg on Twitter and GitHub bgranger@calpoly.edu and ellisonbg@gmail.com

npscience commented 6 years ago

We're up! https://elifesciences.org/labs/8653a61d/introducing-binder-2-0-share-your-interactive-research-environment (you don't need the text bit at the end of the link)

npscience commented 6 years ago

And we're out https://twitter.com/eLifeInnovation/status/936264573170212864

minrk commented 6 years ago

Yay! Thanks, everyone!

minrk commented 6 years ago

Jupyter link: https://twitter.com/ProjectJupyter/status/936265849366892545

Carreau commented 6 years ago

Thanks ! I'm taking care of sending that to our facebook page.

ellisonbg commented 6 years ago

Congrats everyone!!!

On Thu, Nov 30, 2017 at 9:10 AM, Matthias Bussonnier < notifications@github.com> wrote:

Thanks ! I'm taking care of sending that to our facebook page.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/jupyterhub/binder/issues/22#issuecomment-348236118, or mute the thread https://github.com/notifications/unsubscribe-auth/AABr0CZdmDaIq48E6hWFxAkDQBjJWDkAks5s7tOCgaJpZM4P50pr .

-- Brian E. Granger Associate Professor of Physics and Data Science Cal Poly State University, San Luis Obispo @ellisonbg on Twitter and GitHub bgranger@calpoly.edu and ellisonbg@gmail.com

choldgraf commented 6 years ago

Wohoo!!!

choldgraf commented 6 years ago

getting a nice bump folks (last two hours are on the right)

image

betatim commented 6 years ago

You people are amazing :) Thank you.

choldgraf commented 6 years ago

closing this! hooray! 🎉