index.html

---
# Feel free to add content and custom Front Matter to this file.
# To modify the layout, see https://jekyllrb.com/docs/themes/#overriding-theme-defaults

layout: default
---


<h1>Community Code Review</h1>
    <p class="fs-5 col-md-8">Welcome to the website of the Community Code Review Working Group of <a href="https://dh-tech.github.io/">DHTech</a>! </p>

   <p>
      <i>Code review</i> is a widespread technique to improve software and reduce the number of flaws. In a code review, a programmer (other than the original code author(s)) reviews the source code. They ask questions and make suggestions for improving the software. In addition to identifying and eliminating errors, code review can improve overall quality by making the source code more readable and maintainable.</p>

<p> Many Digital Humanities projects are build by rather small teams which makes such reviews challenging. This working group has developed a community code review system for the digital humanities to enable external reviews by volunteers. </p>
<p>You can become part of the working group in various roles. Submit your code or join the pool of potential reviewers or facilitators. You are also welcome to join our working group meetings, see <a href="https://dh-tech.github.io/working-groups/">DHTech Working Groups</a>.</p>

    <p>
        <a href="submit-code.html" class="btn btn-primary btn-sm" type="submit">Submit Code for Review</a>
        &nbsp;
        <a href="https://forms.gle/PepxF6U64AT2Y5TZA" class="btn btn-primary btn-sm" type="submit">Become a Reviewer</a>
        &nbsp;
        <a href="facilitator.html" class="btn btn-primary btn-sm" type="submit">Become a Facilitator</a>
      </p>
    <hr class="col-3 col-md-2 mb-5">

    <h2>Our Process</h2>
    <p>
      We are always trying to improve our code review process to fit best for the needs of the community. Currently, our process is as follows.

      <ul>
        <li>We try to find two reviewers for each piece of code that is submitted for review.</li>
        <li>We schedule two weeks for the review to be completed.</li>
        <li>We schedule an half hour Zoom meeting at the beginning of the review period with both reviewers and the submitter(s) of the code to discuss general questions such as the problem the code is trying to solve, general setup requirements, and any other questions the reviewers might have.</li>
        <li>Reviewers and submitters are being added to a channel in the DHTech Slack workspace where they can communicate about the code and during the review process.</li>
        <li>Reviews are being conducted via pull requests in GitHub.</li>
        <li>We schedule a 1 hour wrap up Zoom meeting with reviewers and submitters to discuss the reviewer's comments on the code and any questions reviewers or submitters might have.</li>
        <li>Submitters are asked to recognize the work of the reviewers by adding their names to the code's repository or in other places where it makes sense.</li>
      </ul>
    </p>

    <hr class="col-3 col-md-2 mb-5">

    <h2>Submission Deadlines</h2>
    <div class="alert alert-warning" role="alert">
      Please note that you do not need a finish product to be able to submit your code for review! You are welcome to <b>submit code that is work in progress</b>. All we ask that you select a piece of code that can be reviewed in about an hour.
    </div>
    <p>
      Our quarterly deadlines to submit code for review are as follows:
    </p>
    <ul>
      <li>March 31</li>
      <li>June 30</li>
      <li>September 30</li>
      <li>December 31</li>
    </ul>

    <p>
      <a href="submit-code.html" class="btn btn-primary btn-sm" type="submit">Submit Code for Review</a>
      &nbsp;
      <a href="https://forms.gle/PepxF6U64AT2Y5TZA" class="btn btn-primary btn-sm" type="submit">Become a Reviewer</a>
      &nbsp;
      <a href="facilitator.html" class="btn btn-primary btn-sm" type="submit">Become a Facilitator</a>
    </p>
    <hr class="col-3 col-md-2 mb-5">
    {% for post in site.posts limit:1 %}
    <h2>{{ post.title}}</h2>
    <p class="blogdate">{{ post.date | date: "%d %B %Y" }}</p>
    <p>
      {{ post.content|truncatewords:60 }}
    </p>
    <p style="text-align:right"><a href="{{ post.url }}">Read more...</a></p>
    {% endfor %}

    <hr class="col-3 col-md-2 mb-5">

    <div class="row g-5">
      <div class="col-md-6">
        <h2>Want to know more?</h2>
        <p>Check out these links to find out more about what we are doing!</p>
        <ul class="icon-list ps-0">
          <li class="d-flex align-items-start mb-1"><a href="recent-reviews.html" rel="noopener">Recent Reviews</a></li>
          <li class="d-flex align-items-start mb-1"><a href="poster.html" rel="noopener">DH2022 Poster</a></li>
        </ul>
      </div>

      <div class="col-md-6">
        <h2>Guides</h2>
        <p>Interested in submitting code for review or becoming a reviewer? Check out the links below for further information.</p>
        <ul class="icon-list ps-0">
          <li class="d-flex align-items-start mb-1"><a href="https://github.com/DHCodeReview/DHCodeReview/wiki/Authors:-Preparing-a-Code-Review">Preparing a Code Review</a></li>
          <li class="d-flex align-items-start mb-1"><a href="https://github.com/DHCodeReview/DHCodeReview/wiki/Conducting-a-Code-Review">Conducting a Code Review</a></li>
          <li class="d-flex align-items-start mb-1"><a href="https://github.com/DHCodeReview/DHCodeReview/wiki/Code-Review-Checklists">Code Review Checklist</a></li>
          <li class="d-flex align-items-start mb-1"><a href="https://github.com/DHCodeReview/DHCodeReview/wiki/Code-Review-Guidelines">Code Review Guidelines</a></li>
        </ul>
      </div>

    </div>