jupyterlab / jupyterlab-demo

Demonstrations of JupyterLab
https://mybinder.org/v2/gh/jupyterlab/jupyterlab-demo/master?urlpath=lab
Other
182 stars 241 forks source link

Feedback from Conferences? #48

Open jzf2101 opened 6 years ago

jzf2101 commented 6 years ago

@willingc @jasongrout @ian-r-rose @ellisonbg @sccolbert @blink1073

Do you have any additional feedback from the conferences you recently spoke at?

willingc commented 6 years ago

Hi @jzf2101, Here's some general feedback from using the demo at PyCon Poland.

I followed pretty much the demo that @jasongrout did at SciPy. The area that gave me the most difficulty was that I couldn't remember the keyboard shortcuts for many of the commands (especially those not accessible from the menu bar). Although I had the keypresses in my speaker notes, A/V issues prevented me from having access to the notes.

I'm not sure how to resolve this in the demo. Perhaps a cheatsheet with the keyboard shortcuts (in a large font) would help. I would print it out and have next to my laptop.

A nice enhancement would be to have a GIF that shows small elements of the demo that could be linked to from a slidedeck (for the user to view after the talk).

jzf2101 commented 6 years ago

@willingc https://github.com/jupyterlab/jupyterlab/issues/2976

jzf2101 commented 6 years ago

See https://github.com/jupyterlab/jupyterlab/issues/3005 as followup

jzf2101 commented 6 years ago

@willingc what parts of the demo are you thinking of turning into GIFs?

willingc commented 6 years ago

@jzf2101 I would do short 10-20 second GIFs to correspond to the slides at the end of this talk (Page 48 starts the JupyterLab demo) https://www.slideshare.net/willingc/python-and-jupyter-your-gateway-for-learning

ellisonbg commented 6 years ago

@jzf2101 and I talked today earlier about the user documentation for JupyterLab (in its regular Sphinx/RTD build). One idea that came up was to have a section on the high-profile feature of JupyterLab - guided by the demo/talks we have been giving. We have a Dropbox Paper document (Project Jupyter Docs/UI/UX Design folder) we are going to use to brainstorm on what the user documentation for lab would look like. It may be that narrative text with screenshots and/or GIFs would be a good way of encoding those features in the user docs.

On Mon, Sep 18, 2017 at 1:21 PM, Carol Willing notifications@github.com wrote:

@jzf2101 https://github.com/jzf2101 I would do short 10-20 second GIFs to correspond to the slides at the end of this talk (Page 48 starts the JupyterLab demo) https://www.slideshare.net/willingc/python-and-jupyter- your-gateway-for-learning

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/jupyterlab/jupyterlab-demo/issues/48#issuecomment-330344383, or mute the thread https://github.com/notifications/unsubscribe-auth/AABr0M-64srAjCvQq1N1KLZBwV1uDih-ks5sjtDCgaJpZM4PRdaJ .

-- 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

willingc commented 6 years ago

@ellisonbg That sounds great!

@jzf2101 Take a look at the nbgrader docs if you haven't already. Jess did a nice job with integrating GIFs into the docs.