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

Time estimate #121

Open
dleehr opened this issue Nov 21, 2017 · 10 comments
Open

Time estimate #121

dleehr opened this issue Nov 21, 2017 · 10 comments
Labels
help wanted Looking for Contributors status:refer to cac Curriculum Advisory Committee input needed type:clarification Suggest change for make lesson clearer

Comments

@dleehr
Copy link

dleehr commented Nov 21, 2017

I'm teaching shell at GCB Academy's Introduction to Scientific Computing for Genomics next week and was very excited to see this lesson in such good shape. We have 3.5 hours minus breaks for each lesson. Since shell-genomics is estimated at 4:00, I'm concerned if it'll fit.

I recognize that the lesson has not been released yet, but was curious how accurate the 4:00 is and how the lesson compares to software carpentry's shell lesson, estimated at 1:35.

Thanks!

@ErinBecker
Copy link
Contributor

@dleehr - Thanks for the question! We're in the process of putting the final touches on this lesson in preparation for publication. The timing estimates are rough guesses, as there have been significant changes to these lessons since they were taught last and they have not been re-timed. My suggestion as you prepare for your workshop is to time yourself working through the lesson and multiply by two! If you wouldn't mind submitting a PR afterwards with your timing so that this lesson could be updated, that would be great.

@samnooij
Copy link
Contributor

samnooij commented Jan 17, 2018

Even though it may be a bit late, I'd like to share my experiences with teaching the Shell Genomics lesson. (This is the workshop link: https://aschuerch.github.io/2017-12-13-amsterdam/)
We had planned to teach this part in 5 hours, for a mixed group of 15 graduate students/post-docs/technicians. In practice, it took me about 5 hours to teach from the introduction up to redirection. Writing scripts and project management had to be postponed to the second day (one hour extra - so about 6 hours total).
The exercises took the most time, especially those in Working with Files and Directories and Redirection. Most learners were done in a few minutes, but some needed more time (10 minutes or more per exercise). So the hardest part was making sure everybody had enough time to finish the exercises by themselves or in pairs. The estimated times in the material is probably right if you strictly give your learners only so many minutes per exercise. We preferred to use some extra time and make sure everybody could follow.
Hope this helps! Good luck with teaching and finding the right timing for your audience!

-- P.S. Let me add some time estimates per episode:
Introducing the Shell (few exercises, estimates are probably right)
Teaching: 20 min
Exercises: 10 min
Navigating Files and Directories (again, estimates look good)
Teaching: 30 min
Exercises: 20 min
Working with Files and Directories (from here on it becomes trickier: 4 exercises; for me it took longer)
Teaching: 30 min
Exercises: 40 min (+25)
Redirection (7 exercises, certainly longer than 15 minutes)
Teaching: 30 min
Exercises: 60 min (+45)
Writing Scripts (from here on we had to speed up a bit, so I mostly just showed how to approach the exercises)
Teaching: 15 min (-5)
Exercises: 15 min (-5)
Project Organization
Teaching: 15 min
Exercises: 15 min

TOTAL time: 300 min, or 5 hours

So I seem to have lost some more time... Perhaps I took some extra time explaining. I don't remember many extra breaks to get everybody up to speed.

ctb pushed a commit to ctb/shell-genomics that referenced this issue Feb 14, 2018
Using page.previous and page.next for links instead of loop
@aschuerch
Copy link
Contributor

Do you have time estimates for the shell lesson for your recent workshop @taylorreiter @raynamharris @ryanpeek ?

@taylorreiter
Copy link
Contributor

@shannonekj

@ryanpeek
Copy link

ryanpeek commented Jun 29, 2018 via email

@ErinBecker ErinBecker added this to the June_2019_release milestone Mar 18, 2019
@ErinBecker ErinBecker added the help wanted Looking for Contributors label Mar 18, 2019
@ErinBecker
Copy link
Contributor

See also: #176

@ErinBecker
Copy link
Contributor

Arizona Bug BBQ - we just taught this lesson in 4 hours, however, we skipped a significant section of the scripts episode. The timings are currently incorrect, but the group is talking about proposing some cuts to the lesson, so these timings would be reevaluated then.

@ErinBecker
Copy link
Contributor

@ryneches - wanna take a stab at this? 😄 (see also #176 for suggested timings)

@akshayparopkari akshayparopkari added status:refer to cac Curriculum Advisory Committee input needed type:clarification Suggest change for make lesson clearer labels May 14, 2020
@p-j-smith
Copy link
Contributor

Current timings are:

title: Introducing the Shell
teaching: 20
exercises: 10

title: Navigating Files and Directories
teaching: 30
exercises: 20

title: Working with Files and Directories
teaching: 30
exercises: 15

title: Redirection
teaching: 30
exercises: 15

title: Writing Scripts and Working with Data
teaching: 20
exercises: 20

title: Project Organization
teaching: 15
exercises: 15

Total time: 4 hours

I don't think these have been updated since this discussion began, but perhaps some content has been removed? Does anyone have some more up-to-date timings for this course, or any plans to run it in the near future? If not, it sounds like the timings for episode 3 and 4 could be extended (based on #121 (comment) and #176).

Also, @akshayparopkari I see you labelled this as 'refer to cac' - is there any update from that referral?

@vhmcck
Copy link
Contributor

vhmcck commented Apr 17, 2024

I also see a total of 4 hours for the 6 episodes within the lesson but without the details on timings for teaching vs. exercises. The totals match. I agree with time adjustments based on previous reports.

The consensus between #121 and #176 would be:

  1. Introducing the shell - 30 minutes.
  2. Navigating files and directories - 40 minutes.
  3. Working with files and directories - 90 minutes.
  4. Redirection - 120 minutes.
  5. Working with files and data - 30 minutes.
  6. Project organisation - 30 minutes.

TOTAL: 340 minutes = 5.7 hours.

However, this does not fit into the 4-hour window.
Should agree on the next steps.

@vhmcck vhmcck pinned this issue Apr 17, 2024
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:clarification Suggest change for make lesson clearer
Projects
None yet
Development

No branches or pull requests

10 participants