Module 5 feedback from Tyler

[mfisher87]

• Started with the default CryoCloud image.
  • Update the "joining late?" dropdown to include specifying how to start the server with the custom image
• Remove slides? Are we going to use slides?
• Minor: Emojis cause indentation to look a bit inconsistent
  • Are the items with emojis intended to be sub-sections of the items above them because the emoji pushes the text to the right? Maybe we could use one boring and consistent emoji for all the other headers? 🤔
• "To preview a MyST site in JupyterLab, view instructions at ..." -> "view instructions in the reference section ...link..."

[tylere]

• “Quick start” menu -> “Quick setup” menu
• "myst-example-site" != "myst-exercise" Need to be consistent with the repo names.

[tylere]

The README.md file instructions for the Zenodo DOI badge didn't work for me.

The README link is displayed:

but the link has a strange, repetitive URL which doesn't lead to an actual page:

https://hub.cryointhecloud.com/user/tylere/myst-build/myst-example-site/myst-build/myst-build/myst-example-site/readme

[tylere]

I like the module progression, but I think there is >60 minutes of content in there, even if you move through it at a rapid clip.

• The "Getting a DOI" could be left as an exercise for the readers to do on their own.

[mfisher87]

but the link has a strange, repetitive URL which doesn't lead to an actual page:

hub.cryointhecloud.com/user/tylere/myst-build/myst-example-site/myst-build/myst-build/myst-example-site/readme

WAT. No other links are weird like that right?

[tylere]

That appears to be the only local link on the page... the other are to external websites (github).

The issue occurs when I preview the site via "Build MyST Project". If I commit the changes to GitHub, the link works on the public page.

git add README.md 
git commit -m 'Add README'
git push -u origin main

results in the link:
https://tylere.github.io/myst-example-site/readme/

which loads correctly:

[mfisher87]

The bug is unique to previous/next page links. It occurs on builds of the workshop website in JupyterHub, and all links work except previous/next page links. Weird. I opened an issue: ryanlovett/jupyter-myst-build-proxy#23

[mfisher87]

Nevermind, term links and internal links in page content are also doing this. Ungood. Looks like navigation links are the exception.

[mfisher87]

WIP: #68