faq.html

---
layout: base
root: .
title: Frequently Asked Questions
---
<div align="center">
  <img src="{{page.root}}/img/workshops/2013-01-mcgill.png" class="img-responsive" alt="Workshop at McGill University, January 2012" />
</div>
<br/>
<div class="well">
  <div class="row">
    <div class="col-sm-6">
      <p><a href="#general">General</a></p>
      <ul>
	<li><a href="#what-is-swc">What is Software Carpentry?</a></li>
	<li><a href="#why-does-swc-exist">Why does Software Carpentry exist?</a></li>
	<li><a href="#relationship-with-data-carpentry">What is the relationship between Software Carpentry and Data Carpentry?</a></li>
	<li><a href="#team">Who created all this?</a></li>
	<li><a href="#sponsors">Who pays for all this?</a></li>
	<li><a href="#core-topics">What is the core of Software Carpentry's curriculum?</a></li>
	<li><a href="#trademark">Who can use the Software Carpentry name and logo?</a></li>
	<li><a href="#more-info">Where can I learn more?</a></li>
      </ul>
      <p><a href="#instructors">Instructor Training</a></p>
      <ul>
	<li><a href="#who-are-your-instructors">Who are the instructors?</a></li>
	<li><a href="#why-become-an-instructor">Why do people become instructors?</a></li>
	<li><a href="#how-become-instructor">How can I become an instructor myself?</a></li>
	<li><a href="#who-can-take-instructor-training">Who can take part in the instructor training course?</a></li>
	<li><a href="#why-do-we-refer-to-our-students-as-learners">Why do we refer to our students as 'learners'?</a></li>
      </ul>
      <p><a href="#miscellaneous">Miscellaneous</a></p>
      <ul>
	<li><a href="#how-contribute">How can I contribute?</a></li>
	<li><a href="#how-acknowledge">How can I acknowledge Software Carpentry in my work?</a></li>
	<li><a href="#other-initiatives">What other initiatives is Software Carpentry connected to?</a></li>
	<li><a href="#citation">How should I cite Software Carpentry?</a></li>
	<li><a href="#buy-stuff">Where can I buy Software Carpentry swag?</a></li>
      </ul>
    </div>
    <div class="col-sm-6">
      <p><a href="#workshops">Workshops</a></p>
      <ul>
	<li><a href="#what-is-workshop">What is a workshop?</a></li>
	<li><a href="#how-much-will-i-learn">Will I really learn all this in just two days?</a></li>
	<li><a href="#workshop-curriculum">Is the workshop curriculum set in stone?</a></li>
	<li><a href="#why-not-teach-x">Why don't you teach X?</a></li>
	<li><a href="#workshop-costs-learner">Are workshops free for learners?</a></li>
	<li><a href="#workshop-costs-host">Are workshops free for hosts?</a></li>
	<li><a href="#workshop-prerequisites">Are any pre-requisite skills necessary to attend a workshop?</a></li>
	<li><a href="#bring-what-to-workshop">Do I need to bring anything to the workshop?</a></li>
	<li><a href="#why-workshop">Why two-day workshops?</a></li>
	<li><a href="#workshop-audience">Who are workshops for?</a></li>
	<li><a href="#effectiveness">Do workshops really work?</a></li>
	<li><a href="#why-else-attend">Why else should I attend a workshop?</a></li>
	<li><a href="#what-if-cant-attend">What if I can't make it to a workshop?</a></li>
	<li><a href="#workshop-format">What does a typical workshop look like?</a></li>
	<li><a href="#how-attend-workshop">How can I attend a workshop?</a></li>
	<li><a href="#attend-in-groups">Should I bring friends?</a></li>
	<li><a href="#how-host-workshop">How can I host a workshop?</a></li>
	<li><a href="#how-run-workshop">How can I run a workshop?</a></li>
	<li><a href="#who-can-run-a-workshop">Can anyone run a workshop?</a></li>
	<li><a href="#commercial-offerings">Can I teach commercially?</a></li>
      </ul>
      <p><a href="#operations">Operations</a></p>
      <ul>
	<li><a href="#becoming-a-core-contributor">How do I become a core contributor?</a></li>
	<li><a href="#where-is-stuff">Where are Software Carpentry materials stored?</a></li>
	<li><a href="#setting-up-workshop-website">How do I set up a website for a workshop?</a></li>
	<li><a href="#creating-lesson">How do I create a new lesson or modify an existing one?</a></li>
	<li><a href="#how-run-workshop">How do I set up and run a workshop?</a></li>
      </ul>
    </div>
  </div>
</div>

<h2 id="general">General</h2>

<dl class="faq">

  <dt id="what-is-swc">What is Software Carpentry?</dt>
  <dd>
    <p>
      Software Carpentry is a volunteer organization whose goal is
      to make scientists more productive,
      and their work more reliable,
      by teaching them basic computing skills.
      Founded in 1998,
      it runs short, intensive workshops that cover
      program design, version control, testing, and task automation.
      The <a href="{{page.root}}/scf/index.html">Software Carpentry Foundation</a>
      was created in October 2014 to act as a governing body for the project.
    </p>
  </dd>

  <dt id="why-does-swc-exist">Why does Software Carpentry exist?</dt>
  <dd>
    <p>
      Because computing is now an integral part of every aspect of science,
      but most scientists are never taught how to build, use, validate, and share software well.
      As a result,
      many spend hours or days doing things badly
      that could be done well in just a few minutes.
      Our goal is to change that
      so that scientists can spend less time wrestling with software
      and more time doing useful research.
    </p>
  </dd>

  <dt id="relationship-with-data-carpentry">What is the relationship between Software Carpentry and Data Carpentry?</dt>
  <dd>
    <p>
      <a href="http://datacarpentry.org/">Data Carpentry</a>
      is a sibling organization
      that focuses on data analysis skills rather than programming skills.
      We share the instructor training program,
      and are represented on one another's steering committees,
      but while our aim is to help scientists who are programming badly learn to program better,
      theirs is to teach people who are wrangling data manually
      how to automate make their work and make it more reproducible.
    </p>
  </dd>

  <dt id="team">Who created all this?</dt>
  <dd>
    <p>
      <a href="{{page.root}}/pages/team.html">Many people</a>
      have helped Software Carpentry grow
      by creating lessons,
      teaching workshops,
      and building its web site&mdash;you can find
      a fuller description in <a href="{{page.root}}/blog/2013/06/lessons-learned.html">this blog post</a>.
    </p>
  </dd>

  <dt id="sponsors">Who pays for all this?</dt>
  <dd>
    <p>
      The costs associated with particular workshops are covered by their hosts:
      our instructors are volunteers,
      so these costs usually amount to travel and accommodation.
      Central costs,
      such as instructor training and curriculum development,
      are paid for by
      <a href="{{page.root}}/scf/workshops.html">an administration fee</a>
      for workshops that we help arrange,
      by <a href="{{page.root}}/scf/membership.html">membership dues</a> from
      our <a href="{{page.root}}/scf/supporters.html">partners and affiliates</a>,
      and by <a href="{{site.paypal_url}}">donations</a> from supporters like you.
    </p>
  </dd>

  <dt id="core-topics">What is the core of Software Carpentry's curriculum?</dt>
  <dd>
    <p>
      Our core topics are:
    </p>
    <ul>
      <li>
        automating tasks using the Unix shell;
      </li>
      <li>
        structured programming in Python, R, or MATLAB; and
      </li>
      <li>
        version control using Git or Mercurial.
      </li>
    </ul>
  </dd>

  <dt id="trademark">Who can use the Software Carpentry name and logo?</dt>
  <dd>
    <p>
      The name "Software Carpentry" and the
      <a href="{{page.root}}/img/software-carpentry-banner.png">Software Carpentry logo</a>
      are both trademarked,
      and may only be used with our explicit prior permission.
      We normally grant this to any training course that:
    </p>
    <ul>
      <li>covers our <a href="#core-topics">core topics</a>, </li>
      <li>has at least one <a href="{{page.root}}/pages/team.html">certified instructor</a> teaching,</li>
      <li>runs our standardised pre- and post-workshop assessment forms and provides us with the results
      (please contact us by email at <a href="mailto:{{site.contact}}">{{site.contact}}</a>
      to obtain copies of the assessment forms), and</li>
      <li>sends us summary information about attendees (at a minimum, the number of people who attended).</li>
    </ul>
    <p>
      Please contact us by email at <a href="mailto:{{site.contact}}">{{site.contact}}</a>
      for more information.
    </p>
  </dd>

  <dt id="more-info">Where can I learn more?</dt>
  <dd>
    <p>
      We have documented our experiences in
      "<a href="http://arxiv.org/abs/1210.0530">Best Practices for Scientific Computing</a>"
      and
      "<a href="http://arxiv.org/abs/1307.5448">Software Carpentry: Lessons Learned</a>",
      and in a handful of <a href="{{page.root}}/blog/index.html#popular">popular blog posts</a>.
      For more information,
      please see our web site
      at <a href="http://software-carpentry.org/">http://software-carpentry.org</a>,
      or contact us by email at <a href="mailto:{{site.contact}}">{{site.contact}}</a>.
    </p>
  </dd>

</dl>

<h2 id="instructors">Instructor Training</h2>

<dl>

  <dt id="who-are-your-instructors">Who are the instructors?</dt>
  <dd>
    <p>
      Our instructors are scientists themselves&mdash;in fact,
      many are workshop alumni.
    </p>
  </dd>

  <dt id="why-become-an-instructor">Why do people become instructors?</dt>
  <dd>
    <p>
      For many reasons:
    </p>
    <ul>
      <li>
        <em>To make their own lives better.</em>
        By teaching their fellow scientists how to build and share better software,
        our instructors are indirectly helping to create things that they themselves can use.
      </li>
      <li>
        <em>Because it's fun.</em>
        How could it not be?
      </li>
      <li>
        <em>To build a reputation.</em>
        Teaching a workshop is a great way for people to introduce themselves to places they'd eventually like to work,
        and a great way to make contact with potential collaborators.
      </li>
      <li>
        <em>Get practice teaching.</em>
        We're doing more every year to train instructors,
        and giving them chances to teach online as well&mdash;both of which are useful for people with academic careers in mind.
      </li>
      <li>
        <em>Help get people of diverse backgrounds into the pipeline.</em>
        Computer Science is 12-15% female,
        and that figure has been <em>dropping</em> since the 1980s.
        Some of our instructors are involved in part because they want computational science to include a broader range of people.
      </li>
      <li>
        <em>Teaching forces you to learn new things, or learn old things in more detail than you already know.</em>
        See for example "<a href="http://www.sciencemag.org/content/333/6045/1037.abstract">Graduate Students' Teaching Experiences Improve Their Methodological Research Skills</a>".
      </li>
      <li>
        <em>The more you know, the less you have to write yourself.</em>
        Putting a grant application together? Have a site review coming up?  We probably have slides for that... :-)
      </li>
      <li>
        <em>To make the world a better place.</em>
        The two things we need to get through the next hundred years are more science and more courage.
        Software Carpentry can't do much about the latter,
        but we can help with the former.
      </li>
    </ul>
  </dd>

  <dt id="how-become-instructor">How can I become an instructor myself?</dt>
  <dd>
    <p>
      We offer a <a href="{{site.training_url}}">free online training course</a>
      for people who would like to teach Software Carpentry,
      and to learn more about teaching in general along the way.
      The course takes 2-4 hours a week for 12-14 weeks (depending on interruptions);
      most work is done on trainees' own time,
      and is posted to the <a href="{{site.training_url}}">course blog</a>.
    </p>
  </dd>

  <dt id="who-can-take-instructor-training">Who can take part in the instructor training course?</dt>
  <dd>
    <p>
      While we would like to help everyone learn how to teach programming,
      space in the course is limited.
      We therefore give preference to people who have taken part in a workshop themselves,
      are planning to host a workshop,
      or have relevant prior experience.
      For more information,
      please <a href="mailto:{{site.contact}}">send us email</a>.
    </p>
  </dd>

  <dt id="why-do-we-refer-to-our-students-as-learners">Why do we refer to students as 'learners'?</dt>
  <dd>
    <p>
     We settled on "learner" to avoid confusion:
     many professors don't think of themselves as students.
    </p>
  </dd>

</dl>

<h2 id="miscellaneous">Miscellaneous</h2>

<dl>

  <dt id="how-contribute">How can I contribute?</dt>
  <dd>
    <p>
      There are many other ways you can help beyond teaching.
      These include writing new lessons,
      answering learners' questions online,
      and maintaining this web site:
      please see <a href="{{page.root}}/pages/projects.html">this page</a> for details.
      We are also always looking for more sponsors:
      please <a href="mailto:{{site.contact}}">mail us</a> if you'd like to help.
    </p>
  </dd>

  <dt id="how-acknowledge">How can I acknowledge Software Carpentry's help in my own work?</dt>
  <dd>
    <p>
      We appreciate being mentioned in the acknowledgments sections of papers, theses, and proposals,
      as it helps us show current and potential funders what impact we're having.
      If you would like to do this,
      please use something like the following:
    </p>
    <blockquote>
      We were aided in this work by the training and other support offered by the Software Carpentry project [1].
      <br/>
      [1] Software Carpentry: http://software-carpentry.org.
    </blockquote>
  </dd>

  <dt id="other-initiatives">What other initiatives is Software Carpentry connected to?</dt>
  <dd>
    <p>
      Software Carpentry has a close relationship with <a href="http://datacarpentry.org/">Data Carpentry</a>,
      which teaches basic concepts, skills, and tools for working more effectively with data.
      We also work with many other organizations:
      please see our <a href="{{page.root}}/scf/supporters.html">list of supporters</a> for details.
    </p>
  </dd>
  <dt id="#citation">How should I cite Software Carpentry?</dt>
  <dd>
    <p>
      Please see our <a href="{{page.root}}/CITATION">CITATION</a> file for references.
    </p>
  </dd>

  <dt id="buy-stuff">Where can I buy Software Carpentry swag?</dt>
  <dd>
    <p>
      Shirts, mugs, stickers, and buttons are for sale
      in our <a href="{{site.store_url}}">CafePress store</a>.
    </p>
  </dd>

</dl>

<h2 id="workshops">Workshops</h2>

<dl>

  <dt id="what-is-workshop">What is a workshop?</dt>
  <dd>
    <p>
      A workshop is a hands-on combination of instruction and programming,
      typically two days long,
      that covers the <a href="#core-topics">core skills needed to be productive in a small research team</a>.
    </p>
  </dd>

  <dt id="how-much-will-i-learn">Will I really learn all this in just two days?</dt>
  <dd>
    <p>
      Not all of it&mdash;not even most of it&mdash;but
      enough to do your work more efficiently,
      and to start taking advantage of online resources
      like <a href="http://stackoverflow.com/">Stack Overflow</a>
      that assume a certain level of background knowledge.
    </p>
  </dd>

  <dt id="workshop-curriculum">Is the workshop curriculum set in stone?</dt>
  <dd>
    <p>
      Our audience is as diverse as science itself,
      so we do our best to tailor our teaching to each group's needs.
      However,
      any workshop that wants to
      <a href="#trademark">use our name and logo</a>
      must cover <a href="#core-topics">a few core topics</a>.
    </p>
  </dd>

  <dt id="why-not-teach-x">Why don't you teach X?</dt>
  <dd>
    <p>
      Data visualization,
      high-performance computing (HPC),
      Perl:
      the list of things we don't teach is much longer than the list of things we do.
      As with every curriculum,
      the question is not, "What would we like to add?"
      but, "What are we willing to take out in order to make room?"
      We believe our <a href="#core-topics">core topics</a>
      are the absolute minimum scientists need to know
      in order to do computing well.
      We also believe that topics like HPC are covered well enough by other groups.
    </p>
  </dd>

  <dt id="workshop-costs-learner">Are workshops free for learners?</dt>
  <dd>
    <p>
      Some workshops charge $20-$40 for registration,
      primarily because it reduces the number of people who register but not attend
      from 20-25% to roughly 5%.
    </p>
  </dd>

  <dt id="workshop-costs-host">Are workshops free for hosts?</dt>
  <dd>
    <p>
      The Software Carpentry Foundation charges
      <a href="{{page.root}}/scf/workshops.html">an administration fee</a>
      for workshops that it helps arrange.
      This money is used to cover central costs such as instructor training
      and curriculum development.
      There is no fee for workshops that host sites arrange on their own,
      and we encourage organizations to do this.
    </p>
  </dd>

  <dt id="workshop-prerequisites">Are any pre-requisite skills necessary to attend a workshop?</dt>
  <dd>
    <p>
      The only truly necessary skill is a desire to become more efficient and effective when using a computer in scientific research.
      Each workshop is unique,
      and people with different skill levels will bring home different lessons,
      but everyone will learn something useful.
      That said,
      when we have enough space and instructors,
      we do try to stream people according to prior knowledge
      so that we can tailor training for them.
    </p>
  </dd>

  <dt id="bring-what-to-workshop">Do I need to bring anything to the workshop?</dt>
  <dd>
    <p>
      In most cases, yes:
      workshops are meant to be hands-on,
      which means your hands should be on a keyboard while you're learning.
      We encourage people to bring their own laptops
      so that they leave the workshop with a working set of tools installed and operational.
      Some sites have computers for training,
      but please arrange this in advance with the instructors.
    </p>
    <p>
      We also ask people to install the software their workshop requires <em>before</em> showing up,
      so that we don't have three dozen people trying to download installers
      through the same wireless network at once.
      Each workshop's instructors will circulate a list of required software
      (and installation instructions) on the workshop website
      well in advance of the start.
    </p>
  </dd>

  <dt id="why-workshop">Why two-day workshops?</dt>
  <dd>
    <p>
      Between 1998 and 2012,
      we taught this material in intensive week-long courses,
      as a regular university course,
      and online,
      with varying degrees of frustration.
      It turns out that researchers are busy people:
      improving their computing skills will make them more productive in the long run,
      but in the short run,
      they have to get a grant proposal in by Thursday,
      mark mid-terms by Monday,
      and meet a paper deadline next week.
      While two days may not sound like much,
      it's all many researchers can fit in.
    </p>
  </dd>

  <dt id="workshop-audience">Who are workshops for?</dt>
  <dd>
    <p>
      Our learners are typically graduate students
      in science, engineering, medicine, and related research-intensive disciplines
      who have written a few lines of code
      (either on their own or for an "Intro to Computing" class as undergrads)
      but aren't familiar with computing's equivalent of good laboratory practices.
      <a href="{{page.root}}/pages/audience.html">These short bios</a>
      are representative of their needs
      and how we can help.
    </p>
  </dd>

  <dt id="effectiveness">Do workshops really work?</dt>
  <dd>
    <p>
      Yes:
      two independent studies in 2012 found that people really were learning useful things,
      and <a href="{{page.root}}/pages/testimonials.html">these testimonials</a> from past participants
      show just how much difference a couple of days of training can make.
      We are now using standardized pre- and post-assessment questionnaires and interviews
      to gain more insight.
    </p>
  </dd>

  <dt id="why-else-attend">Why else should I attend a workshop?</dt>
  <dd>
    <p>
      Along with their immediate benefits,
      workshops are a great opportunity to network with like-minded researchers.
      These skills are also useful for people transitioning out of research
      into other careers in science, technology, engineering, and medicine.
    </p>
  </dd>

  <dt id="what-if-cant-attend">What if I can't make it to a workshop?</dt>
  <dd>
    <p>
      If there isn't a workshop near you,
      please check our <a href="{{page.root}}/workshops/index.html#calendar">calendar</a>
      for one near a conference or other meeting that you're attending.
      We also have a large number of <a href="{{page.root}}/lessons.html">online video tutorials</a>
      that cover most of our core material.
      Like everything else on our site,
      these are free to use under a Creative Commons license.
    </p>
  </dd>

  <dt id="workshop-format">What does a typical workshop look like?</dt>
  <dd>
    <p>
      Workshops usually run for two consecutive days,
      starting at 8:30 and running to 4:30 or 5:00 each day
      with breaks for coffee and lunch.
      A typical workshop has 40 learners,
      2 instructors,
      and 2-3 helpers wandering the room answering questions during practical sessions.
      (These helpers are often alumni of previous workshops
      who are hoping to become instructors themselves.)
    </p>
    <p>
      Short tutorials alternate with hands-on practical exercises,
      and participants are encouraged both to help one another,
      and to apply what they are learning to their own research problems
      during, between, and after sessions.
    </p>
  </dd>

  <dt id="how-attend-workshop">How can I attend a workshop?</dt>
  <dd>
    <p>
      Dates and venues of upcoming workshops are on our <a href="{{page.root}}/workshops/index.html#">calendar</a>.
      They are also announced on our <a href="{{page.root}}/blog/index.html">blog</a>,
      on <a href="{{site.twitter_url}}">Twitter</a>,
      and through our <a href="{{page.root}}/pages/join.html">announcements list</a>.
    </p>
  </dd>

  <dt id="attend-in-groups">Should I bring friends?</dt>
  <dd>
    <p>
      Absolutely.
      We have found in the past that if people attend in groups
      (e.g., if a whole lab's worth of students show up together),
      then everyone gets more out of the training.
      People who sign up together are more likely to have similar interests and backgrounds,
      and are usually less inhibited about asking questions,
      and asking one another for help,
      than total strangers.
      Plus,
      it's a great opportunity to wear that departmental t-shirt that's sitting in your drawer...
    </p>
  </dd>

  <dt id="how-host-workshop">How can I host a workshop?</dt>
  <dd>
    <p>
      If you'd like us to teach a workshop for you,
      the first step is to <a href="mailto:{{site.contact}}">get in touch</a>.
      We'll find instructors in your geographic and/or academic area,
      and do advertising, registration, and software setup,
      while you'll take care of travel costs and administrative overheads,
      booking space,
      local publicity,
      finding helpers,
      and catering (if desired).
      If you want to know more about what is involved in running a workshop,
      please see our <a href="{{page.root}}/workshops/operations.html">operations guide</a>.
    </p>
  </dd>

  <dt id="how-run-workshop">How can I run a workshop?</dt>
  <dd>
    <p>
      Anyone who wants to run a workshop can do so&mdash;all
      our teaching materials are freely available under
      the <a href="{{page.root}}/license.html">Creative Commons Attribution license</a>,
      so you are free to re-use and re-mix them when and how you want
      so long as you cite us at the original source
      (e.g., by providing a link back to this site).
      If you want to know more about what is involved in running a workshop,
      please see our <a href="{{page.root}}/workshops/operations.html">operations guide</a>.
    </p>
  </dd>

  <dt id="who-can-run-a-workshop">Can anyone run a workshop?</dt>
  <dd>
    <p>
      While anyone can use our material,
      the name "Software Carpentry" and our logo are both trademarked,
      and may only be used if
      <a href="#trademark">certain conditions</a> are met.
      We're all in favor of teaching people iPhone game programming,
      multigrid methods using C++ and MPI,
      and scientific grant writing,
      but we've worked hard to establish an identity for Software Carpentry,
      and wish to protect it.
    </p>
  </dd>

  <dt id="commercial-offerings">Can I teach commercially?</dt>
  <dd>
    <p>
      Yes,
      but you may not call your course "Software Carpentry"
      or use our logo
      without <a href="#trademark">first obtaining permission</a>.
    </p>
  </dd>

</dl>

<h2 id="operations">Operations</h2>

<dl>

  <dt id="becoming-a-core-contributor">How do I become a core contributor?</dt>
  <dd>
    <p>
      A core contributor is someone who can commit changes directly to our shared repositories.
      The process for becoming one
      is taken directly from <a href="http://docs.python.org/devguide/coredev.html">the Python project</a>:
      when you have consistently contributed patches which meet quality standards without requiring extensive rewrites prior to being committed,
      you may qualify for commit privileges and become a core contributor of Software Carpentry.
      You must also work well with other core contributors (and people in general)
      as you become an ambassador for the project.
    </p>
  </dd>

  <dt id="where-is-stuff">Where are Software Carpentry materials stored?</dt>
  <dd>
    <p>
      All of our slides, notes, and example programs are in Git repositories at
      <a href="{{site.github_url}}">{{site.github_url}}</a>,
      and the source for our website (including our blog) at
      <a href="{{site.github_url}}/site">{{site.github_url}}/site</a>.
    </p>
  </dd>

  <dt id="setting-up-workshop-website">How do I set up a website for a workshop?</dt>
  <dd>
    <p>
      For instructions on setting up a website for a workshop,
      please see the <a href="{{site.github_url}}/workshop-template">workshop template home page</a>
      or <a href="{{site.github_url}}/slideshows/creating-website/index.html">this slideshow</a>.
    </p>
  </dd>

  <dt id="creating-lesson">How do I create a new lesson or modify an existing one?</dt>
  <dd>
    <p>
      The template for lessons lives in
      <a href="{{site.github_url}}/lesson-template">this GitHub repository</a>.
      For instructions on creating a new lesson or modifying an existing one,
      please see the <a href="{{site.github_url}}/lesson-example">lesson example home page</a>
      or <a href="{{site.github_url}}/slideshows/creating-lesson/index.html">this slideshow</a>.
    </p>
  </dd>

  <dt id="how-run-workshop">How do I set up and run a workshop?</dt>
  <dd>
    <p>
      Please see our <a href="{{page.root}}/workshops/operations.html">operations guide</a>
      for instructions on setting up and running a workshop.
      This includes links to <a href="{{page.root}}/workshops/checklists/index.html">our checklists</a>
      and the <a href="{{page.root}}/workshops/assess/index.html">surveys</a> we use
      to assess learners' and instructors' experiences.
    </p>
  </dd>

</dl>