Skip to content

Commit 9cc85d9

Browse files
copying over from MDS
1 parent e776298 commit 9cc85d9

36 files changed

Lines changed: 1268 additions & 297 deletions

AUTHORS

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
* [Martin Kwok](https://github.com/kakwok)
2+
* [Christina Wang](https://github.com/Christinaw97/)

CITATION

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
FIXME: describe how to cite this lesson.

CONTRIBUTING.md

Lines changed: 151 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,151 @@
1+
# Contributing
2+
3+
[The Carpentries][c-site] ([Software Carpentry][swc-site], [Data Carpentry][dc-site], and [Library Carpentry][lc-site]) are open source projects,
4+
and we welcome contributions of all kinds:
5+
new lessons,
6+
fixes to existing material,
7+
bug reports,
8+
and reviews of proposed changes are all welcome.
9+
10+
## Contributor Agreement
11+
12+
By contributing,
13+
you agree that we may redistribute your work under [our license](LICENSE.md).
14+
In exchange,
15+
we will address your issues and/or assess your change proposal as promptly as we can,
16+
and help you become a member of our community.
17+
Everyone involved in [The Carpentries][c-site]
18+
agrees to abide by our [code of conduct](CODE_OF_CONDUCT.md).
19+
20+
## How to Contribute
21+
22+
The easiest way to get started is to file an issue
23+
to tell us about a spelling mistake,
24+
some awkward wording,
25+
or a factual error.
26+
This is a good way to introduce yourself
27+
and to meet some of our community members.
28+
29+
1. If you do not have a [GitHub][github] account,
30+
you can [send us comments by email][email].
31+
However,
32+
we will be able to respond more quickly if you use one of the other methods described below.
33+
34+
2. If you have a [GitHub][github] account,
35+
or are willing to [create one][github-join],
36+
but do not know how to use Git,
37+
you can report problems or suggest improvements by [creating an issue][issues].
38+
This allows us to assign the item to someone
39+
and to respond to it in a threaded discussion.
40+
41+
3. If you are comfortable with Git,
42+
and would like to add or change material,
43+
you can submit a pull request (PR).
44+
Instructions for doing this are [included below](#using-github).
45+
46+
## Where to Contribute
47+
48+
1. If you wish to change this lesson,
49+
please work in <https://github.com/swcarpentry/FIXME>,
50+
which can be viewed at <https://swcarpentry.github.io/FIXME>.
51+
52+
2. If you wish to change the example lesson,
53+
please work in <https://github.com/carpentries/lesson-example>,
54+
which documents the format of our lessons
55+
and can be viewed at <https://carpentries.github.io/lesson-example>.
56+
57+
3. If you wish to change the template used for workshop websites,
58+
please work in <https://github.com/carpentries/workshop-template>.
59+
The home page of that repository explains how to set up workshop websites,
60+
while the extra pages in <https://carpentries.github.io/workshop-template>
61+
provide more background on our design choices.
62+
63+
4. If you wish to change CSS style files, tools,
64+
or HTML boilerplate for lessons or workshops stored in `_includes` or `_layouts`,
65+
please work in <https://github.com/carpentries/styles>.
66+
67+
## What to Contribute
68+
69+
There are many ways to contribute,
70+
from writing new exercises and improving existing ones
71+
to updating or filling in the documentation
72+
and submitting [bug reports][issues]
73+
about things that do not work, are not clear, or are missing.
74+
If you are looking for ideas, please see the 'Issues' tab for
75+
a list of issues associated with this repository,
76+
or you may also look at the issues for [Data Carpentry][dc-issues],
77+
[Software Carpentry][swc-issues], and [Library Carpentry][lc-issues] projects.
78+
79+
Comments on issues and reviews of pull requests are just as welcome:
80+
we are smarter together than we are on our own.
81+
Reviews from novices and newcomers are particularly valuable:
82+
it is easy for people who have been using these lessons for a while
83+
to forget how impenetrable some of this material can be,
84+
so fresh eyes are always welcome.
85+
86+
## What *Not* to Contribute
87+
88+
Our lessons already contain more material than we can cover in a typical workshop,
89+
so we are usually *not* looking for more concepts or tools to add to them.
90+
As a rule,
91+
if you want to introduce a new idea,
92+
you must (a) estimate how long it will take to teach
93+
and (b) explain what you would take out to make room for it.
94+
The first encourages contributors to be honest about requirements;
95+
the second, to think hard about priorities.
96+
97+
We are also not looking for exercises or other material that will only run on one platform.
98+
Our workshops typically contain a mixture of Windows, macOS, and Linux users;
99+
in order to be usable,
100+
our lessons must run equally well on all three.
101+
102+
## Using GitHub
103+
104+
If you choose to contribute via GitHub, you may want to look at
105+
[How to Contribute to an Open Source Project on GitHub][how-contribute].
106+
To manage changes, we follow [GitHub flow][github-flow].
107+
Each lesson has at least two maintainers who review issues and pull requests or encourage others to do so.
108+
The maintainers are community volunteers and have final say over what gets merged into the lesson.
109+
To use the web interface for contributing to a lesson:
110+
111+
1. Fork the originating repository to your GitHub profile.
112+
2. Within your version of the forked repository, move to the `gh-pages` branch and
113+
create a new branch for each significant change being made.
114+
3. Navigate to the file(s) you wish to change within the new branches and make revisions as required.
115+
4. Commit all changed files within the appropriate branches.
116+
5. Create individual pull requests from each of your changed branches
117+
to the `gh-pages` branch within the originating repository.
118+
6. If you receive feedback, make changes using your issue-specific branches of the forked
119+
repository and the pull requests will update automatically.
120+
7. Repeat as needed until all feedback has been addressed.
121+
122+
When starting work, please make sure your clone of the originating `gh-pages` branch is up-to-date
123+
before creating your own revision-specific branch(es) from there.
124+
Additionally, please only work from your newly-created branch(es) and *not*
125+
your clone of the originating `gh-pages` branch.
126+
Lastly, published copies of all the lessons are available in the `gh-pages` branch of the originating
127+
repository for reference while revising.
128+
129+
## Other Resources
130+
131+
General discussion of [Software Carpentry][swc-site], [Data Carpentry][dc-site], and [Library Carpentry][lc-site]
132+
happens on the [discussion mailing list][discuss-list],
133+
which everyone is welcome to join.
134+
You can also [reach us by email][email].
135+
136+
[email]: mailto:team@carpentries.org
137+
[dc-issues]: https://github.com/issues?q=user%3Adatacarpentry
138+
[dc-lessons]: http://datacarpentry.org/lessons/
139+
[dc-site]: http://datacarpentry.org/
140+
[discuss-list]: https://carpentries.topicbox.com/groups/discuss
141+
[github]: https://github.com
142+
[github-flow]: https://guides.github.com/introduction/flow/
143+
[github-join]: https://github.com/join
144+
[how-contribute]: https://app.egghead.io/playlists/how-to-contribute-to-an-open-source-project-on-github
145+
[issues]: https://guides.github.com/features/issues/
146+
[swc-issues]: https://github.com/issues?q=user%3Aswcarpentry
147+
[swc-lessons]: https://software-carpentry.org/lessons/
148+
[swc-site]: https://software-carpentry.org/
149+
[c-site]: https://carpentries.org/
150+
[lc-site]: https://librarycarpentry.org/
151+
[lc-issues]: https://github.com/issues?q=user%3Alibrarycarpentry

README.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# CMSDAS: Muon Detector Shower (MDS) Long Ex
2+
3+
[![Create a Slack Account with us](https://img.shields.io/badge/Create_Slack_Account-The_Carpentries-071159.svg)](https://swc-slack-invite.herokuapp.com/)
4+
5+
This repository generates the corresponding lesson website from [The Carpentries](https://carpentries.org/) repertoire of lessons.
6+
7+
## Contributing
8+
9+
We welcome all contributions to improve the lesson! Maintainers will do their best to help you if you have any
10+
questions, concerns, or experience any difficulties along the way.
11+
12+
We'd like to ask you to familiarize yourself with our [Contribution Guide](CONTRIBUTING.md) and have a look at
13+
the [more detailed guidelines][lesson-example] on proper formatting, ways to render the lesson locally, and even
14+
how to write new episodes.
15+
16+
Please see the current list of [issues][FIXME] for ideas for contributing to this
17+
repository. For making your contribution, we use the GitHub flow, which is
18+
nicely explained in the chapter [Contributing to a Project](http://git-scm.com/book/en/v2/GitHub-Contributing-to-a-Project) in Pro Git
19+
by Scott Chacon.
20+
Look for the tag ![good_first_issue](https://img.shields.io/badge/-good%20first%20issue-gold.svg). This indicates that the maintainers will welcome a pull request fixing this issue.
21+
22+
23+
## Maintainer(s)
24+
25+
Current maintainers of this lesson are
26+
27+
* [Martin Kwok](https://github.com/kakwok)
28+
* [Christina Wang](https://github.com/Christinaw97/)
29+
30+
31+
[lesson-example]: https://carpentries.github.io/lesson-example

_config.yml

Lines changed: 108 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -1,61 +1,120 @@
1-
# Carpentries lesson configuration
2-
# See https://carpentries.github.io/lesson-example/ for details
1+
#------------------------------------------------------------
2+
# Values for this lesson.
3+
#------------------------------------------------------------
34

4-
title: "CMS DAS Long Exercise: Measurement of B0s→μ+μ−"
5+
# Which carpentry is this ("swc", "dc", "lc", or "cp")?
6+
# swc: Software Carpentry
7+
# dc: Data Carpentry
8+
# lc: Library Carpentry
9+
# cp: Carpentries (to use for instructor traning for instance)
10+
# incubator: Carpentries Incubator
11+
carpentry: "swc"
12+
13+
# Overall title for pages.
14+
title: "CMSDAS: Muon Detector Shower (MDS) Long Exercise"
15+
16+
# Life cycle stage of the lesson
17+
# See this page for more details: https://cdh.carpentries.org/the-lesson-life-cycle.html
18+
# Possible values: "pre-alpha", "alpha", "beta", "stable"
19+
#
20+
# Lessons that are going through the transition to the
21+
# Carpentries Workbench will go through 3 steps:
22+
# 'transition-step-1': notice indicating a new version
23+
# 'transition-step-2': notice encouraging to use new version
24+
# 'transition-step-3': notice indicating the lesson is deprecated,
25+
# with automated redirect
26+
life_cycle: "alpha"
27+
28+
# For lessons in the life stages in 'transition-step-1' or later:
29+
# - 'transition_url' holds the URL for the version of the lesson that
30+
# uses the Workbench (needed for all 3 steps)
31+
# - 'transition_date' (in yyyy-mm-dd format) is the date when the lesson
32+
# will transition to being deprecated. The date only needs to be decided
33+
# when the lesson is in 'transition-step-2'.
34+
transition_url:
35+
transition_date:
36+
37+
#------------------------------------------------------------
38+
# Generic settings (should not need to change).
39+
#------------------------------------------------------------
40+
41+
# What kind of thing is this ("workshop" or "lesson")?
542
kind: "lesson"
6-
carpentry: "incubator"
743

8-
# Set the default layout for pages in this lesson
44+
# Magic to make URLs resolve both locally and on GitHub.
45+
# See https://help.github.com/articles/repository-metadata-on-github-pages/.
46+
# Please don't change it: <USERNAME>/<PROJECT> is correct.
47+
repository: kakwok/MDS_CMSDAS
48+
49+
# Email address, no mailto:
50+
email: "team@carpentries.org"
51+
52+
# Sites.
53+
coc: "https://docs.carpentries.org/topic_folders/policies/code-of-conduct.html"
54+
amy_site: "https://amy.carpentries.org/"
55+
carpentries_github: "https://github.com/carpentries"
56+
carpentries_pages: "https://carpentries.github.io"
57+
carpentries_site: "https://carpentries.org/"
58+
dc_site: "https://datacarpentry.org"
59+
example_repo: "https://github.com/carpentries/lesson-example"
60+
example_site: "https://carpentries.github.io/lesson-example"
61+
lc_site: "https://librarycarpentry.org/"
62+
swc_github: "https://github.com/swcarpentry"
63+
swc_pages: "https://swcarpentry.github.io"
64+
swc_site: "https://software-carpentry.org"
65+
template_repo: "https://github.com/carpentries/styles"
66+
training_site: "https://carpentries.github.io/instructor-training"
67+
workshop_repo: "https://github.com/carpentries/workshop-template"
68+
workshop_site: "https://carpentries.github.io/workshop-template"
69+
cc_by_human: "https://creativecommons.org/licenses/by/4.0/"
70+
71+
# Surveys.
72+
pre_survey: "https://carpentries.typeform.com/to/wi32rS#slug="
73+
post_survey: "https://carpentries.typeform.com/to/UgVdRQ#slug="
74+
instructor_pre_survey: "https://carpentries.typeform.com/to/QVOarK#slug="
75+
instructor_post_survey: "https://carpentries.typeform.com/to/cjJ9UP#slug="
76+
77+
# Set to 'true' for instructor training websites only.
78+
instructor_training: false
79+
80+
# Start time in minutes (0 to be clock-independent, 540 to show a start at 09:00 am).
81+
start_time: 0
82+
83+
# Specify that things in the episodes collection should be output.
84+
collections:
85+
episodes:
86+
output: true
87+
permalink: /:path/index.html
88+
extras:
89+
output: true
90+
permalink: /:path/index.html
91+
92+
# Set the default layout for things in the episodes collection.
993
defaults:
1094
- values:
1195
root: .
1296
layout: page
97+
- scope:
98+
path: ""
99+
type: episodes
100+
values:
101+
root: ..
102+
layout: episode
103+
- scope:
104+
path: ""
105+
type: extras
106+
values:
107+
root: ..
108+
layout: page
13109

14-
# Event details (update each year)
15-
venue: "LPC CMS Data Analysis School"
16-
address: "Fermi National Accelerator Laboratory, Batavia, IL"
17-
country: "us"
18-
language: "en"
19-
latitude: "41.842282"
20-
longitude: "-88.255637"
21-
humandate: "January 2026"
22-
humantime: ""
23-
startdate: ""
24-
enddate: ""
25-
26-
instructor: []
27-
helper: []
28-
email: []
29-
30-
collaborative_notes: ""
31-
eventbrite: ""
32-
33-
# Links
34-
github: "https://github.com/FNALLPC/LongExerciseBsMuMu"
35-
repo: "LongExerciseBsMuMu"
36-
root: "."
37-
baseurl: "/LongExerciseBsMuMu"
38-
url: "https://fnallpc.github.io"
39-
life_cycle: "stable"
40-
build_pdf: "no"
41-
42-
# Lesson-specific
43-
workshop_repo: "https://github.com/FNALLPC/LongExerciseBsMuMu"
44-
workshop_site: "https://fnallpc.github.io/LongExerciseBsMuMu"
45-
110+
# Files and directories that are not to be copied.
46111
exclude:
47112
- Makefile
48113
- bin/
49114
- .Rproj.user/
50-
- .Rhistory
51-
- .RData
52-
- etc/
53-
54-
plugins:
55-
- jekyll-redirect-from
56-
57-
# Keep these last
58-
markdown: kramdown
59-
kramdown:
60-
syntax_highlighter_opts:
61-
disable: true
115+
- .vendor/
116+
- vendor/
117+
- .docker-vendor/
118+
119+
# Turn on built-in syntax highlighting.
120+
highlighter: rouge

0 commit comments

Comments
 (0)