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

docs(sessions): 📝 include learning outcomes for course #46

Merged
merged 3 commits into from
Oct 7, 2024
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 41 additions & 4 deletions preamble/syllabus.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,46 @@

{{< include ../includes/_wip.qmd >}}

Objectives:

- Item 1
## Learning outcomes

Our overall learning outcome for the course is:

1. Describe some core features of effective team-based, collaborative
workflows and identify the components that make these workflows
effective compared to other workflows. Then use a set of tools and
approaches that strongly support effective collaboration.
lwjohnst86 marked this conversation as resolved.
Show resolved Hide resolved

This outcome is broken down into specific learning objectives that will
be addressed within the individual sessions:

1. Explain what humans as a group need psychologically and
organizationally in order to work well together as a team. (*this is
lwjohnst86 marked this conversation as resolved.
Show resolved Hide resolved
to remove thoughts people have that "this doesn't work for me, I
work best in chaos", to emphasize, it isn't about individuals, it's
about the group*)
Copy link
Member

Choose a reason for hiding this comment

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

Should this parenthesis be removed? 😅

Suggested change
organizationally in order to work well together as a team. (*this is
to remove thoughts people have that "this doesn't work for me, I
work best in chaos", to emphasize, it isn't about individuals, it's
about the group*)
organizationally in order to work well together as a team.

Copy link
Member Author

Choose a reason for hiding this comment

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

Yes, it was more for you and me to be clear about, I guess I should have written that as a PR comment 😛 ooppsss

2. Discuss the different ways people work together as a team and
identify how some ways work better than others for doing effective
teamwork.
lwjohnst86 marked this conversation as resolved.
Show resolved Hide resolved
3. Describe how the widely used Git and GitHub are used for
collaboration and explain their biggest strengths (and weaknesses)
over alternatives, as well as review the basics of using Git and
GitHub.
lwjohnst86 marked this conversation as resolved.
Show resolved Hide resolved
4. Setup a project on GitHub (called a repository) and apply some key
lwjohnst86 marked this conversation as resolved.
Show resolved Hide resolved
settings on GitHub to improve collaboration and teamwork.
5. Differentiate between contributor and reviewer/admin roles in a team
lwjohnst86 marked this conversation as resolved.
Show resolved Hide resolved
and why they should be dynamic and explicit.
6. Create and use a task list (called issues) to assign team members to
tasks that they are responsible for.
7. Apply a contributor workflow of selecting an issue to work on,
creating an isolated section of a repository (called branches),
making small and distinct changes to files (called atomic commits)
with clear messages on why or what was changed, and contributing
those changes into the main branch of a repository in small and
distinct steps (called pull requests).
lwjohnst86 marked this conversation as resolved.
Show resolved Hide resolved
8. Apply a reviewer/admin workflow of reviewing a pull request with
changes, giving suggestions and feedback, and identifying how (and
if) the changes should be merged back into the main branch of a
repository.
lwjohnst86 marked this conversation as resolved.
Show resolved Hide resolved

## Is this course for you? {#sec-is-it-for-you}

Expand Down Expand Up @@ -43,4 +80,4 @@ This course will **NOT** cover:
- Using any programming language (like R or Python)

- Any project management, for example related to tasks/issues (even
though we briefly cover issues)
though we briefly cover issues)