Generalizing data 8 references

[ryanlovett]

The datahub repo is home to many deployments now, each for different courses. The processes outline in this textbook are still highly relevant for those other courses. For example if I want to point the Data 100 instructors and GSIs at the docs for how to do things like update the single user image, I'd send them a link to this textbook with a note about replacing all data 8 related links (hub, docker image manifest, syllabus, course website, etc.) with their data100 equivalents.

That's simple enough, but I wonder if this textbook should be refactored so that it is less data8-specific -- basically following the "keep it generalized" mantra of z2jh. I just wanted to get your thoughts on this. If there's some interest maybe we can spitball here?

[choldgraf]

I think something like this would be a good idea - I think the link to Data 8 is helpful just for people who are coming explicitly with that in mind, but I agree that the stack as a whole is much more than data 8. Do you think it'd require refactoring the name of the book itself?

[ryanlovett]

Cool! I don't think it'd require changing the name but it might be confusing otherwise. "Data 8" is known outside of Berkeley and I think for a certain audience, "Zero to Data 8" has an obvious meaning. For others it might not be as meaningful, especially if the Data 8 specific mentions are abstracted out. But that decision could probably be left until the end should anything come out of this issue.

[ryanlovett]

Would it be helpful if I started by itemizing all of the Data 8 specific mentions (usually URLs) of the book?

[choldgraf]

Another thought is if we pulled out the pieces of this book that are data-8-agnostic, and had a different guide that we called out to (like "zero to jupyterhub for education").

Your suggestion seems like a reasonable place to start just to see what kind of changes we're talking about here

[ryanlovett]

Okay, tagging my opinion of generalizable items as z2jh4e.

1. intro - data8
2. deploy
   a. README - z2jh4e
   b. choose_cloud - z2jh4e
   c. setup_jupyterhub - z2jh4e
   d. customize_hub_environment - z2jh4e
   e. connect_website_and_textbook - data8 (heavily dependent on inferentialthinking though mentions customizing the textbook)
   f. connect_labs_and_homework - z2jh4e
   • Uses data8.org and data-8 git repo in example.
   • homework section is heavily oriented to data8 w/ OKpy. Could be generalized if augmented with other grading options.
     g. course_logistics - z2jh4e
     h. deploy_locally - data8 (essentially about the textbook)
3. tech
   a. README intro - z2jh4e
   b. considerations - z2jh4e
   c. tech - z2jh4e
   d. team - z2jh4e (generalizable, but uses data8 as example)
   e. deployment - z2jh4e (has data8 links for hubs, github repo, helm chart, docker images)
4. teaching
   a. README - data8
   b. inspiration - data8 "Decisions made" section has a couple of general items
   c. syllabus - data8
5. misc
   a. connectors - data8
   b. links - 1 link is z2jh4e, 2 links are data8
   c. faq - 2 questions are z2jh4e, 1 question is data8 (materials)

[ryanlovett]

So maybe deploy+tech-teaching forms z2jh4e with a new intro? If so I can try that in a fork which rebrands/generalizes Data 8 as "JupyterHub For Education" to see how it reads.

[choldgraf]

I'm curious what other folks at the DSEP would think about this. Do you think that they'd be hesitant to rebrand anything? And if so, maybe Z2JH4E would be more like a separate resource that would live in parallel, and over time we could start replacing information here with links to there?

[ryanlovett]

Hmm, not sure about the others in dsep.

For now I think I'll make a berkeley-dsep-infra/zero-to-jh4edu fork with just the generalized deploy and tech bits. This will help me help the non-data8 instructors and gsis. I may ask you questions about the book deployment process. :)

[choldgraf]

That all sounds good to me, I don't see any problem with keeping two parallel versions. Does that work for you in the short term?

[ryanlovett]

Yep, should be fine.

[choldgraf]

Lemme know when you have another site up, and I can link to it from Z2D8!