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

Add Learner Profiles #5

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Add Learner Profiles #5

wants to merge 3 commits into from

Conversation

astroDimitrios
Copy link
Collaborator

@astroDimitrios astroDimitrios commented Jan 30, 2024

Closes #4 - adding learner profiles and pathways.

@astroDimitrios astroDimitrios added documentation Improvements or additions to documentation help wanted Extra attention is needed labels Jan 30, 2024
@astroDimitrios astroDimitrios self-assigned this Jan 30, 2024
Copy link

github-actions bot commented Jan 30, 2024

Thank you!

Thank you for your pull request 😃

🤖 This automated message can help you check the rendered files in your submission for clarity. If you have any questions, please feel free to open an issue in {sandpaper}.

If you have files that automatically render output (e.g. R Markdown), then you should check for the following:

  • 🎯 correct output
  • 🖼️ correct figures
  • ❓ new warnings
  • ‼️ new errors

Rendered Changes

🔍 Inspect the changes: https://github.com/carpentries-incubator/intro-to-modern-fortran/compare/md-outputs..md-outputs-PR-5

The following changes were observed in the rendered markdown documents:

 config.yaml         |  1 -
 instructor-notes.md | 12 +++++++++++-
 learner-profiles.md | 25 +++++++++++++++++++++++--
 links.md            |  2 ++
 md5sum.txt          |  8 ++++----
 5 files changed, 40 insertions(+), 8 deletions(-)
What does this mean?

If you have source files that require output and figures to be generated (e.g. R Markdown), then it is important to make sure the generated figures and output are reproducible.

This output provides a way for you to inspect the output in a diff-friendly manner so that it's easy to see the changes that occur due to new software versions or randomisation.

⏱️ Updated at 2024-02-21 10:11:34 +0000

github-actions bot pushed a commit that referenced this pull request Jan 30, 2024
@jonaslindemann
Copy link

I like the concept of learner profiles, but I think it is important that it doesn't complicate the structure of a course. Perhaps have separate document on with suggested paths throuigh the course.

@cmcooling
Copy link

I think Learner Profiles can be useful as a tool for developing content, but I'm less convinced in their utility as a student-facing thing. I worry they could bog the student down. I think that the profiles themselves probably are useful.

One suggestion I had comes from how we organise our own courses and dependencies, using this tool. Using this users can select topics they're interested in and the tool picks out a learning path. Something similar could allow students to pick things that are relevant to them and the tool could dynamically generate a path through the material. Just a thought that sprang to mind.

@astroDimitrios
Copy link
Collaborator Author

Thanks @cmcooling @jonaslindemann! I was under the mistaken impression that the Profiles page was only visible in Instructor View - turns out it is the other way around. Perhaps this is something I can ask of the Workbench devs as to why that is. I think a Pathways page should be visible to Learners. I love the pathways tool - is it an Imperial only site or are there ways we could add to / use it?


***Malak is mathematics graduate student working on new timestepping methods.*** Malaks previous work was mostly theoretical although he knows basic Python. Malak needs to use Fortran to prototype his new routines which will interface with other Fortran code. Malak has been told by his supervisor that he should set up his preferred text editor for Fortran development.

***Joe has been employed by a tech company to update their Fortran code.*** Joe has years of experience developing code but has not used Fortran in a production environment. They have been asked to update legacy code to modern standards, including implementing some form of testing and using standard libraries. Joe is not sure if there is a standard code style that they can adopt.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is there value in splitting Joe into Experienced programmer in compiled language vs Experienced programmer in non-compiled language? As a Joe who came to fortran as an experienced programmer in non-compiled softly typed languages it was a double whammy of compiling and strict types that a c++ programmer would not face.

Copy link

@joeHickson joeHickson Feb 1, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I realise the C++ background variant is covered by Ionas and the non compiled untyped background (potentially at a more junior level) by Tahani.
On reflection I wonder if this means the role/purpose of Joe is not clearly defined enough


***Ionas, a researcher joining the JULES (Joint UK Land Environment Simulator) partnership.*** They will be adding new functionality to JULES in Fortran. They have extensive experience with C and C++ and have been told there are differences between Fortran and C/C++ that they should be aware of. They are keen to learn Fortran but must fit their learning inbetween teaching duties and other research commitments.

***Malak is mathematics graduate student working on new timestepping methods.*** Malaks previous work was mostly theoretical although he knows basic Python. Malak needs to use Fortran to prototype his new routines which will interface with other Fortran code. Malak has been told by his supervisor that he should set up his preferred text editor for Fortran development.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I feel like Malak knows their way around in matlab ;)

Add in pathways diagram with Mermaid.
github-actions bot pushed a commit that referenced this pull request Feb 20, 2024
Small update to one learner profile.
github-actions bot pushed a commit that referenced this pull request Feb 21, 2024
@astroDimitrios
Copy link
Collaborator Author

I have made a small update to Joe's profile. I have also split the profiles out and moved them into the instructor notes. This leaves the learning pathways in the learner profiles page which is visible to students (couldn't work out an easy way to change the name as even the page title for learner-profiles.md is not respected). The flowchart for the pathways is a mermaid diagram which will require #7 to render. I have added it here so you can see the rendered draft without checking out the whole branch:

flowchart TD
    accTitle: Learner Pathways for the Introduction to Modern Fortran Course
    accDescr {This diagram shows the possible learning pathways after completing the Introduction to Modern Fortran course.
    The Intermediate and Advanced Topics in Modern Fortran courses are in the pre-alpha stage.
    The MPI and OpenMP courses are from ARCHER2, the UK's national supercomputing facility, courses.}
    A["Introduction to Modern Fortran <br>(this course)"] --> B
    B[Intermediate Modern Fortran] --> C & D & E
    C[Advanced Topics<br>in Modern Fortran]
    D[Message-passing<br>Programming with MPI]:::archer2
    E[Shared Memory<br>Programming with OpenMP]:::archer2
    classDef archer2 stroke:#64c2ab
    click D href "https://www.archer2.ac.uk/training/courses/#message-passing-programming-with-mpi" "Link to the MPI Archer2 Course"
    click E href "https://www.archer2.ac.uk/training/courses/#shared-memory-programming-with-openmp" "Link to the OpenMP Archer2 Course"
Loading

@astroDimitrios astroDimitrios marked this pull request as ready for review February 21, 2024 10:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation help wanted Extra attention is needed
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add Learner Profiles and Pathways to the lesson
4 participants