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

Possible incorrect link to Anaconda install instructions #646

Open
marklcrowe opened this issue May 19, 2023 · 4 comments
Open

Possible incorrect link to Anaconda install instructions #646

marklcrowe opened this issue May 19, 2023 · 4 comments
Labels
help wanted Looking for Contributors status:refer to cac Curriculum Advisory Committee input needed type:feedback Issue to provide feedback on lesson

Comments

@marklcrowe
Copy link
Contributor

The link at the bottom of page http://swcarpentry.github.io/python-novice-gapminder/ giving instructions for Anaconda installation "Python section of the workshop website for installation instructions" goes to an old template page with the header "FIXME". The actual information on that page is relevant and correct, but it seems wrong if it's directing people to a template-only page in a retired format.

@alee alee added status:refer to cac Curriculum Advisory Committee input needed help wanted Looking for Contributors type:feedback Issue to provide feedback on lesson labels May 19, 2023
@alee
Copy link
Member

alee commented May 19, 2023

oof, thanks for letting us know! I think this is a broader question for the carpentries python maintainers and curriculum advisors @swcarpentry/curriculum-advisors

as I understand it atm these are shared instructional content across multiple carpentries python lessons...

@tobyhodges
Copy link
Member

tobyhodges commented May 19, 2023

@marklcrowe thanks for raising this. While it is not ideal that the page has all those FIXMEs at the top, the workshop template itself is not retired. The lessons have moved over to the new infrastructure, but the https://carpentries.github.io/workshop-template/ template is still the default. (I hope we will have a new way of generating workshop websites soon, but not yet.)

@meronvermaas
Copy link

I noticed this as well, and it goes further than the python novice gapminder lesson material.
Shell has the same link to the template page, which indeed is not very elegant.
Interestingly (and applicable to this python lesson) the other python software carpentry found a more elegant solution: https://swcarpentry.github.io/python-novice-inflammation/index.html#setup
Maybe this could be the text for the set-up of this lesson as well?

PS: The R lessons found a different solution without linking to the template as well.

@zkamvar
Copy link
Contributor

zkamvar commented Jun 29, 2023

The lessons have moved over to the new infrastructure, but the https://carpentries.github.io/workshop-template/ template is still the default.

A note on this: The Workshop template was built from the bones of the lesson template, but it serves a very different purpose (a template page for a single event that changes only a few variables vs. a long-lived document contributed to by many that can vary greatly in content) and thus requires a different mindset in the design. In fact, in 2019, there was an issue opened to remove the workshop template content from the original lesson template: carpentries/styles#421. As Toby mentioned, it's not going anywhere for the moment because it still serves its purpose.

the other python software carpentry found a more elegant solution: https://swcarpentry.github.io/python-novice-inflammation/index.html#setup
Maybe this could be the text for the set-up of this lesson as well?

I think this is a good solution and it's worth mentioning that this question about where setup instructions should live has been around for a while (see carpentries/maintainer-RFCs#9) and we haven't been able to address it yet. Now that we have The Workbench in place, we may be able to implement a protocol to address it, but it will take some time to design it in a way that is both user-friendly and robust.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
help wanted Looking for Contributors status:refer to cac Curriculum Advisory Committee input needed type:feedback Issue to provide feedback on lesson
Projects
None yet
Development

No branches or pull requests

5 participants