Skip to content
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

Add definitions using glosario? #3

Closed
mine-cetinkaya-rundel opened this issue Aug 25, 2020 · 2 comments
Closed

Add definitions using glosario? #3

mine-cetinkaya-rundel opened this issue Aug 25, 2020 · 2 comments

Comments

@mine-cetinkaya-rundel
Copy link
Contributor

See https://github.com/carpentries/glosario-r/. We have feedback that links to Wikipedia articles are distracting, but this might be more focused?

petzi53 added a commit to petzi53/ims-tutorials that referenced this issue Jul 28, 2021
Tutorial OpenIntroStat#3 has now 10 lessons. Provide links to them. This has to be done for all lessons in the tutorial on regression modelling (copy & paste).

I will provide the next few days also the changes for the book to this issue.

NOTE: I could not manage the R code for the emoji of lesson 10 and have it included as inline icon. `r emo:ji("ten")` displays a 10 o'clock watch in my installation.

NOTE: Lesson 6 cannot be called because of a missing graph in a knitr::include_graphics() command. (lines 457-458). I think I have found the problem: graphic of chunk "mpg-data-parallel" has to be saved + called. If this is correct a PR to this issue will follow.
mine-cetinkaya-rundel added a commit that referenced this issue Jul 28, 2021
* Add missing lessons to TOC

Tutorial #3 has now 10 lessons. Provide links to them. This has to be done for all lessons in the tutorial on regression modelling (copy & paste).

I will provide the next few days also the changes for the book to this issue.

NOTE: I could not manage the R code for the emoji of lesson 10 and have it included as inline icon. `r emo:ji("ten")` displays a 10 o'clock watch in my installation.

NOTE: Lesson 6 cannot be called because of a missing graph in a knitr::include_graphics() command. (lines 457-458). I think I have found the problem: graphic of chunk "mpg-data-parallel" has to be saved + called. If this is correct a PR to this issue will follow.

* Update 03-model/01-lesson/03-01-lesson.Rmd

Co-authored-by: Mine Cetinkaya-Rundel <cetinkaya.mine@gmail.com>
@petzi53
Copy link
Contributor

petzi53 commented Jul 30, 2021

Erroneously I linked to this issue when I mentioned Tutorial no. 3 with a hash sign immediately before the number. 🤭 In the future, I will be more cautious with hash signs.

But after saying this, it is also a good occasion to comment on your thoughts about a glossary:

Yes, I can understand that some students find Wikipedia links distracting. There is always too much (and irrelevant) text to read for the special problem at hand.

But generally, I think each textbook should have its own glossary. For me, this would be necessary for a self-contained product, even if you can find similar glossaries in many other places. Students should have the possibility to look up terms via a glossary index as an annex at the end of the book.

If the ims-book would have a glossary, then the online (HTML) version could also serve as an anchor where other material (such as the ims-tutorial) could link to it or (even better) where users could hover over the terms and get a short definition from the glossary as a tooltip. With a tooltip, you wouldn't be distracted so much as you remain on the same page/place and do not disrupt the reading flow as with footnotes or hyperlinks.

I still have to investigate the carpentries package you are referring to. At the moment, I always got the error message, "Some references are slugs that are not found".

@mine-cetinkaya-rundel
Copy link
Contributor Author

Closing this issue since we didn't get much traction on it so far.

OferEngel pushed a commit to OferEngel/ims-tutorials-4-umcg that referenced this issue Jan 17, 2024
* Add missing lessons to TOC

Tutorial OpenIntroStat#3 has now 10 lessons. Provide links to them. This has to be done for all lessons in the tutorial on regression modelling (copy & paste).

I will provide the next few days also the changes for the book to this issue.

NOTE: I could not manage the R code for the emoji of lesson 10 and have it included as inline icon. `r emo:ji("ten")` displays a 10 o'clock watch in my installation.

NOTE: Lesson 6 cannot be called because of a missing graph in a knitr::include_graphics() command. (lines 457-458). I think I have found the problem: graphic of chunk "mpg-data-parallel" has to be saved + called. If this is correct a PR to this issue will follow.

* Update 03-model/01-lesson/03-01-lesson.Rmd

Co-authored-by: Mine Cetinkaya-Rundel <cetinkaya.mine@gmail.com>
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

No branches or pull requests

2 participants