carpentries / workshop-template

The Carpentries Workshop Template
https://carpentries.github.io/workshop-template/
Other
235 stars 521 forks source link

Java Prereq for openrefine #575

Open brownsarahm opened 5 years ago

brownsarahm commented 5 years ago

a learner today had to install java and pointed out that java is not a listed prequisite on the setup instructions. In the (DC-SS) openrefine lesson, it does mention that java is required on that setup page, but that assumes this was followed already, so it's a little confusing

rgaiacs commented 5 years ago

a learner today had to install java and pointed out that java is not a listed prequisite on the setup instructions.

This is true. I understand the learner frustration. What OS is the learner using?

In the (DC-SS) openrefine lesson, it does mention that java is required on that setup page, but that assumes this was followed already, so it's a little confusing

I would say that we already do a great job by listing the dependencies that we are going to use in the workshop. Make the list more complete will scare learners and add extra work for us. For example, Chrome depends on ALSA, FFmpeg, Cairo and other libraries. And Firefox depends on SQLite3 and other libraries. Usually, when you install the software all the dependencies are installed as well. The challenge with OpenRefine is that they provide the binary files and not a installer.

brownsarahm commented 5 years ago

the learner was using a microsoft surface pro (which might be testing the line of tablet/laptop a little more than should be as well...)

fmichonneau commented 4 years ago

I think this needs to be addressed. Looking into this, I discovered that the OpenRefine GitHub Wiki has pretty clear and detailed instructions about installing OpenRefine and installing Java. We could point to these instructions.

Would someone be willing to write a pull request to address the need to have Java installed as a pre-requisite for OpenRefine?

brownsarahm commented 4 years ago

the openrefine installation instructions have been pushed to individual lesson repos, do we want this java prereq in the workshop template or should this issue be replicated on the various openrefine lessons?