Alpha testing feedback

[caifand]

Hi,

Thanks for creating the package and inviting me to test it. I indeed like it and look forward to using it for my own lesson. To be clear I am an R Studio user, so I feel the process is very intuitive to me. Besides, the current documentation reads great and entertaining :)

I haven't encountered major holdbacks. Just note several minor points here in case I forget them:

• When creating the nested callouts, it seems that a newline is needed between the inner and outer callouts. Otherwise the creation would fail. I am not sure if it has anything to do with my environment. I am working on the newest version of R Studio on Windows 10. If it is a thing that everyone needs to look out for, perhaps it would be something to be specified in documentation?

• It is very cool to enable the emoji in the template. I assume it follows the GitHub Markdown syntax so they can be properly rendered on GitHub Page. But I am not able to get correctly rendered emojis from my local disk. So it may create confusion when users are trying to preview their lessons in the local environment. Again, not sure if it has anything to do with my OS or other environmental elements

• I also have something rendered not super neatly from my local, reasons unknown:
  

• It might be good to accompany the screenshots in the Setup chapter with alt text as well. If that would be desired I can help with that edit.

Happy to chat more if these are not clear enough :)

[zkamvar]

Thank you for being so detailed in your feedback. I can confirm that Windows machines set to different locales will not display emoji correctly and will work towards figuring out if there is a fix for that.

Update. This is an issue with Windows code pages creating mojibake locally (the screenshot below was captured using codepage 949). This is in part because there are historical problems supporting UTF-8 locales on Windows in R (see https://developer.r-project.org/Blog/public/2020/07/30/windows/utf-8-build-of-r-and-cran-packages/index.html)

This image was adapted from the following markdown (with most of the prose removed) to highlight the issue

https://github.com/zkamvar/sandpaper-docs/blob/4a62a86230eb51730cc3b6b12d39b01b7c3529da/episodes/episodes.Rmd#L231-L245

[zkamvar]

I just realised that I never updated this: R 4.2.0 on Windows now has native UTF-8 support 🎉, so this issue should no longer be a problem for folks with this version.