Lesson Infrastructure Subcommittee 2017 November meeting

This post originally appeared on the Software Carpentry website.

On 16 November 2017 at 15:00 UTC+0, the Lesson Infrastructure Subcommittee had their 2017 November meeting. This post will cover the topics discussed and their resolutions.

Software Carpentry and Data Carpentry merger

With the merger in 2018, some Git repositories will be owned by a new GitHub organization. The Instructor Training course material has already been moved, you can now find it at http://carpentries.github.io/instructor-training/. Date for the migration will be announced in 2018. Instructions for migrating the repository can be find here.

Syntax Highlight

Thanks to naught101, the next release of our lesson will offer syntax highlighting to our readers. Lesson maintainers might need help to change

~~~
print("Hello World")
~~~
{: .foobar}

to

~~~
print("Hello World")
~~~
{: .language-foobar}

for example. If you want to help, send a pull request to us.

Exercises Throughout the Episodes

After a small discussion, we reached the consensus that it will be better to have exercises throughout the episodes instead of all the exercises at the end of the episode. Lessons will migrate to the new format in a slow pace because this change requires a good amount of work.

Non-English Lessons

If you are involved with us since 2014, you might remember this post about the attempt to translate the lesson to Spanish and this other post announcing the lessons in Korean. During the meeting, we had a conversation about the workflow to translate lessons to other languages, and there is now interest and work on a translation.

Some of the conversation was archived as issues here. If you want to get involved with the translation join the Latinoamerica email list or see the updates.

Windows Installer

In March 2018, a discussion about our recommended text editor created a lot of buzz on the mailing list. The email thread started because sometimes nano wasn’t installed on the learners’ machines. The new version of Git Bash will include nano by default and we have a pull request, thanks to Oliver Stueker, to adopt the new version in our workshop instructions. The pull request will be merged at the end of this year or beginning of 2018.

Next steps

Version 9.3.x lesson template and lesson documentation was released. Maintainers are working to release the new version of the lessons before the end of the year.

The subcommittee will meet again in February to provide an update on some of the topics covered by this post and discuss new requests from the community.

Acknowledgement

Thanks to Alejandra Gonzalez Beltran, Christina Koch, David Pérez-Suárez, Erin Becker, Naupaka Zimmerman and Tracy Teal.