refactor: early spring cleaning

2019/README.md

@@ -1,11 +1,34 @@
-# BDPA National HSCC 2019 Problem Statement
+# BDPA NHSCC 2019 Problem Statements
 
-This was not the problem statement issued during the 2019 competition, but it is
-very similar. It has been retrofitted to conform with the new competition format
-and is suitable for teams to train with for future competitions.
+This was not the problem statement released during the 2019 competition, but it
+is very similar. The original 2019 problem statement was extended to conform
+with the new competition format and is okay to use as training material.
 
-The demo implementation of this solution can be found
-[here](https://github.com/nhscc/2019.solutions.hscc.bdpa.org).
+## Key Challenges
 
-The API implementation used for this problem statement can be found
-[here](https://github.com/nhscc/elections.api.hscc.bdpa.org).
+This year's problem statements were designed with the following challenges in
+mind:
+
+- Interacting with unreliable sometimes-unavailable external data sources
+- Implementing or tweaking a non-trivial algorithm
+- Implementing an authentication mechanism, i.e. login and registration
+- [Responsive UX](https://en.wikipedia.org/wiki/Responsive_web_design), i.e. the
+  app is functional on mobile, tablet, and desktop screens
+- Observing basic application, database, and repository security best practices
+
+## Statements
+
+There was no sample problem statement released this year.
+
+<!-- prettier-ignore-start -->
+
+### [**BDPA Elections**](/2019/elections)
+
+📑 [Problem statement](/2019/elections)  
+🌍 [Live demo](https://elections.solutions.hscc.bdpa.org)  
+📚 [Interactive API docs](https://hscc4cfe8be7.docs.apiary.io/)  
+\-\-\-\-  
+📦 [Demo source code](https://github.com/nhscc/elections.solutions.hscc.bdpa.org)  
+🎒 [API source code](https://github.com/nhscc/elections.api.hscc.bdpa.org)
+
+<!-- prettier-ignore-end -->

2020/README.md

@@ -1,10 +1,43 @@
-# BDPA National HSCC 2020 Problem Statement
+# BDPA NHSCC 2020 Problem Statements
 
-This is the problem statement issued during the 2020 competition and is suitable
-for teams to train with for future competitions.
+The original 2019 problem statement was [**re-imagined**](/2019/elections) as
+the sample statement for 2020. [**BDPA Airports**](/2020/airports) is the actual
+problem statement for 2020.
 
-The demo implementation of this solution can be found
-[here](https://github.com/nhscc/2020.solutions.hscc.bdpa.org).
+## Key Challenges
 
-The API implementation used for this problem statement can be found
-[here](https://github.com/nhscc/airports.api.hscc.bdpa.org).
+This year's problem statements were designed with the following challenges in
+mind:
+
+- Reading dynamically from sometimes-unavailable external data sources
+- Storing, sorting, caching, and filtering large amounts of rapidly evolving
+  data
+- Implementing flexible authentication, i.e. optional login and registration
+- [Responsive UX](https://en.wikipedia.org/wiki/Responsive_web_design), i.e. the
+  app is functional on mobile, tablet, and desktop screens
+- Observing basic application, database, and repository security best practices
+
+## Statements
+
+<!-- prettier-ignore-start -->
+
+### [**BDPA Elections**](/2019/elections)
+
+📑 [Problem statement](/2019/elections)  
+🌍 [Live demo](https://elections.solutions.hscc.bdpa.org)  
+📚 [Interactive API docs](https://hscc4cfe8be7.docs.apiary.io/)  
+\-\-\-\-  
+📦 [Demo source code](https://github.com/nhscc/elections.solutions.hscc.bdpa.org)  
+🎒 [API source code](https://github.com/nhscc/elections.api.hscc.bdpa.org)
+
+### [**BDPA Airports**](/2020/airports)
+
+📑 [Problem statement](/2020/airports)  
+🌍 [Live demo](https://airports.solutions.hscc.bdpa.org)  
+📚 [Interactive API docs](https://hsccdfbb7244.docs.apiary.io/) (version 1)  
+📚 [Interactive API docs](https://hscc210ff8c0.docs.apiary.io/) (version 2)  
+\-\-\-\-  
+📦 [Demo source code](https://github.com/nhscc/airports.solutions.hscc.bdpa.org)  
+🎒 [API source code](https://github.com/nhscc/airports.api.hscc.bdpa.org)
+
+<!-- prettier-ignore-end -->

2020/elections

@@ -0,0 +1 @@
+../2019/elections

2021/README.md

@@ -1,10 +1,3 @@
-# BDPA National HSCC 2021 Problem Statement
+# BDPA NHSCC 2021 Problem Statements
 
-This is the problem statement issued during the 2021 competition and is suitable
-for teams to train with for future competitions.
-
-The demo implementation of this solution can be found
-[here](https://github.com/nhscc/2021.solutions.hscc.bdpa.org).
-
-The API implementation used for this problem statement can be found
-[here](https://github.com/nhscc/X.api.hscc.bdpa.org).
+_TBA_

2022/README.md

@@ -1,10 +1,3 @@
-# BDPA National HSCC 2022 Problem Statement
+# BDPA NHSCC 2022 Problem Statements
 
-This is the problem statement issued during the 2022 competition and is suitable
-for teams to train with for future competitions.
-
-The demo implementation of this solution can be found
-[here](https://github.com/nhscc/2022.solutions.hscc.bdpa.org).
-
-The API implementation used for this problem statement can be found
-[here](https://github.com/nhscc/X.api.hscc.bdpa.org).
+_TBA_

2023/README.md

@@ -1,10 +1,3 @@
-# BDPA National HSCC 2023 Problem Statement
+# BDPA NHSCC 2023 Problem Statements
 
-This is the problem statement issued during the 2023 competition and is suitable
-for teams to train with for future competitions.
-
-The demo implementation of this solution can be found
-[here](https://github.com/nhscc/2023.solutions.hscc.bdpa.org).
-
-The API implementation used for this problem statement can be found
-[here](https://github.com/nhscc/X.api.hscc.bdpa.org).
+_TBA_

2024/README.md

@@ -1,10 +1,3 @@
-# BDPA National HSCC 2024 Problem Statement
+# BDPA NHSCC 2024 Problem Statements
 
-This is the problem statement issued during the 2024 competition and is suitable
-for teams to train with for future competitions.
-
-The demo implementation of this solution can be found
-[here](https://github.com/nhscc/2024.solutions.hscc.bdpa.org).
-
-The API implementation used for this problem statement can be found
-[here](https://github.com/nhscc/X.api.hscc.bdpa.org).
+_TBA_

2025/README.md

@@ -0,0 +1,3 @@
+# BDPA NHSCC 2025 Problem Statements
+
+_TBA_

2026/README.md

@@ -0,0 +1,3 @@
+# BDPA NHSCC 2026 Problem Statements
+
+_TBA_

README.md

@@ -1,2 +1,55 @@
-# problem-statements
-Past NHSCC problem statements and related resources.
+# BDPA NHSCC Problem Statement Archive
+
+Welcome! This is a collection of past and present NHSCC problem statements and
+related resources.
+
+Each problem statement is broken up into two parts: the primary _Problem
+Statement 1_ (PS1), which is released **at least a month before the conference**
+and must be completed within that time frame, and the supplementary _Problem
+Statement 2_ (PS2), which is released **during the conference** and must be
+completed within 8 hours.
+
+Two problem statements are released every year: a _sample_ and an _actual_
+problem statement. Each problem statement pair presents students with a similar
+challenge, so if a team can complete the sample PS1 and PS2, they are in an
+excellent position to do well on the actual competition problem statement.
+
+## This Year's Problem Statements
+
+<!-- Sample: _- TBA -_ <br /> Actual: _- TBA -_ -->
+
+Sample: _- TBA -_ <br /> Actual: _- TBA -_
+
+## Past Problem Statements
+
+Past problem statements and their APIs will remain functional
+_forever_<sup>1</sup>, and can be used as training material for future
+competitions.
+
+<small><sup>1</sup> Unless
+[GitHub Actions](https://github.com/features/actions),
+[MongoDB Atlas](https://www.mongodb.com/cloud/atlas), or
+[Vercel](https://vercel.com/) go down</small>
+
+<!-- prettier-ignore-start -->
+
+### [**BDPA Elections**](/2019/elections)
+
+📑 [Problem statement](/2019/elections)  
+🌍 [Live demo](https://elections.solutions.hscc.bdpa.org) (currently offline)  
+📚 [Interactive API docs](https://hscc4cfe8be7.docs.apiary.io/)  
+\-\-\-\-  
+📦 [Demo source code](https://github.com/nhscc/elections.solutions.hscc.bdpa.org)  
+🎒 [API source code](https://github.com/nhscc/elections.api.hscc.bdpa.org)
+
+### [**BDPA Airports**](/2020/airports)
+
+📑 [Problem statement](/2020/airports)  
+🌍 [Live demo](https://airports.solutions.hscc.bdpa.org) (currently offline)  
+📚 [Interactive API docs](https://hsccdfbb7244.docs.apiary.io/) (version 1)  
+📚 [Interactive API docs](https://hscc210ff8c0.docs.apiary.io/) (version 2)  
+\-\-\-\-  
+📦 [Demo source code](https://github.com/nhscc/airports.solutions.hscc.bdpa.org)  
+🎒 [API source code](https://github.com/nhscc/airports.api.hscc.bdpa.org)
+
+<!-- prettier-ignore-end -->