Comments (6)
Hey @catchSheep, thank you for pointing that out! I think this might not be a problem specific to this lesson, but rather to all transitioned lessons, so I'd like to call @zkamvar in on this.
from python-ecology-lesson.
I initially thought it was due to the transferal to workbench, but looking in the web archive, this goes back to at least 2021: https://web.archive.org/web/20210303055646/https://datacarpentry.org/python-ecology-lesson/index.html
You can see that in the archived page above the url's for each numbered episode are all one lower than what they're listed as
from python-ecology-lesson.
Great, thank you for checking. It appears that some Data Carpentry workshops start numbering their URLs at 01, while others start at 00. In the Software Carpentry lessons it seems to always start with 01, so I believe that would be the way to go here as well.
@tobyhodges What do you think, should we do this as kind of a joined effort for all lessons that have 00 URLs? For DC, those are:
- spreadsheets-socialsci
- r-socialsci
- genomics-r-intro
- spreadsheet-ecology-lesson
- sql-ecology-lesson
- R-ecology-lesson
- python-ecology-lesson
- python-ecology-lesson-es
from python-ecology-lesson.
I agree that the discrepancy is confusing.
There are a couple of ways it could be addressed:
- by renumbering the episode files
- by removing the episode numbers and defining the order of episodes in the repository's
config.yaml
instead.
Option 1 is simpler, option 2 has the advantage that episodes would not need to be renamed if another is added or removed in the future.
Regarding the possibility of coordinating effort across all these repositories, for the sake of expediency I would suggest taking care of it here first. Then someone (@LilithElina, I, or another community member) can propose it to the DC Governance Committee as a solution to be applied across the whole lesson program.
from python-ecology-lesson.
@tobyhodges, I'd suggest to keep the episode numbers as a safeguard in the order specified in config.yaml
. Without numbers, it would be easier to put an episode out of order in config.yaml
.
from python-ecology-lesson.
Thank you @catchSheep for opening this issue. The transition preserved the history of the lesson, so you can see that the last time the episode names were changed was in 2018 36bd123 (this was 8cec912 in the pre-transitioned lesson). In 2014, this lesson was initialized with an episode that started with 00: cd1254e.
Thank you @LilithElina for finding the patterns across the lessons! It's definitely a good idea to make things consistent across our infrastructure. My own personal opinion on the solution: I think it's better to remove the numbers. Name changes like this are not that common, but they are disruptive and there will be broken links outside of this lesson. The episode numbers were initially added in to enforce episode order without engineering a separate ordering mechanism, but it was brittle because lessons do undergo structural changes from time to time as the lesson gets more feedback (some examples are in carpentries/lesson-transition#77 and carpentries/lesson-transition#22 where some episodes were shuffled around and internal links needed to be updated). Considering that the Advisory Committies are releatively new entities, it's reasonable to expect that changes to the lesson structure will happen.
from python-ecology-lesson.
Related Issues (20)
- EP 05 Coding typo HOT 1
- episode 03 - clarity suggestion to text HOT 1
- Topic suggestion - calculating diversity metrics with scikit-bio
- Lesson Contribution: Warning about Word Processors HOT 1
- locate `_include/scripts` HOT 2
- define the workshop directory HOT 3
- use of the word "versus" HOT 1
- Use plotnine in Jupyter Lab HOT 2
- Answers to challenges? HOT 8
- Transition To Workbench in May HOT 9
- Part 2 of "Data Analysis and Visualization in Python for Ecologists": Short Intro to Programming in Python HOT 1
- error type raised by pandas has changed
- Switch plotnine with seaborn and add statannotations HOT 1
- Depreciated default setting gives error with pandas>=2.0.1 HOT 3
- Links need to be fixed in CONTRIBUTING.md HOT 1
- Anaconda may not be easy for everyone HOT 2
- Consider using more up-to-date resources HOT 4
- Environment link is broken HOT 7
- Invalid indexing statement in text block HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from python-ecology-lesson.