added example how to change, various lint cleanup

.markdownlint.json

@@ -0,0 +1,6 @@
+{
+    "MD002": {"level":3},
+    "MD013": false,
+    "MD033": false,
+    "MD041": false
+}

_layouts/base.html

@@ -16,7 +16,7 @@
         {% include banner-header.html %}
       {% endif %}
 
-      <div class="opencdc-content">
+      <div class="opencdc-content" id="content">
         {{ content }}
       </div>
 

_layouts/event.html

@@ -12,7 +12,7 @@
     <main class="col-12 order-lg-2" role="main" aria-label="Main Content Area">
       {% include nav.html %}
 
-      <div class="opencdc-content">
+      <div class="opencdc-content" id="content">
         {{ content }}
       </div>
 

_layouts/home.html

@@ -14,7 +14,7 @@
 
       {% include hero-header.html %} {% if page.banner-heading %}
 
-      <div class="opencdc-content">
+      <div class="opencdc-content" id="content">
         <section class="opencdc-section">
           <div class="opencdc-grid">
             <div class="opencdc-whole-row">

_layouts/search.html

@@ -16,7 +16,7 @@
         {% include banner-header.html %}
       {% endif %}
 
-      <div class="opencdc-content">
+      <div class="opencdc-content" id="content">
         <section class="opencdc-section">
           <div class="opencdc-grid">
             <div class="opencdc-whole-row">

events/hackathon-2018.md

@@ -10,30 +10,31 @@ banner-button-link:
 banner-button-title:
 ---
 
-#### OpenCDC Hackathon: Oct. 3rd + 4th
+### OpenCDC Hackathon: Oct. 3rd + 4th
+
 ![OpenCDC Hackathon October 3rd and 4th 2018][hackathon-banner]
 
 Registration is now available for the OpenCDC Hackathon scheduled for October 3–4, 2018, and co-sponsored by the Office of the Chief Information Officer (OCIO) and the Division of Health Informatics and Surveillance (DHIS) in the Center for Surveillance, Epidemiology, and Laboratory Services (CSELS). Hosted by the Accelerator Team (XLR) in DHIS, the hackathon is open to all CDC employees, including FTEs, contractors, and fellows, interested in open source technologies, innovation, and collaboration at CDC.
- 
+
 During the hackathon, participants from across CDC will engage in collaborative computer programming to solve one of five identified challenges that the agency has or is likely to encounter. To solve the hackathon challenges, participants will use modern technology available to CDC personnel such as the Open Shift platform, Docker, MongoDB, and microservices.
- 
+
 Organizers planned the hackathon to increase participants’ awareness of tools and technologies available to CDC employees, help participants gain hands-on experience using these new tools, promote cross-CIO collaborations and relationships, and create new code or solutions that could be immediately put into practice to solve real business needs at CDC.
- 
+
 To register, please complete the form at [https://go.usa.gov/xUfPG](https://go.usa.gov/xUfPG) by October 1, 2018.  The hackathon will be located at the CDC Roybal Campus, Building 19, Auditorium B1/B2.
- 
+
 If you have questions or need more information, please contact the DHIS Accelerator Team at [[email protected]](mailto:[email protected]) or read the [CDC Connects article](http://intranet.cdc.gov/connects/2017/08/29/hackathon-aims-to-modernize-cdc-software/) about the team’s last hackathon held May 23–24, 2017.
 
 Download the [hackathon poster here]({{ site.baseurl }}/assets/pdf/2018-CDC-hackathon.pdf).
 
 [hackathon-banner]: {{ site.baseurl }}/assets/img/hackathon-banner.png "OpenCDC Hackathon October 3rd and 4th 2018"
 
-##### Agenda
+#### Agenda
 
-The event is located at the **CDC Roybal Campus, Building 19, Auditorium B1/B2**. 
+The event is located at the **CDC Roybal Campus, Building 19, Auditorium B1/B2**.
 
 - [Directions to Roybal Campus](https://www.google.com/maps/place/1600+Clifton+Rd,+Atlanta,+GA+30329/@33.7992368,-84.3308615,17z/data=!3m1!4b1!4m5!3m4!1s0x88f506f648586a9b:0x905afff3a437c574!8m2!3d33.7992368!4d-84.3286728?hl=en)
 
-**Day 1 - Wednesday, October 3, 2018**
+##### Day 1 - Wednesday, October 3, 2018
 
 | Time | Location | Description |
 | -------- | -------- | -------- |
@@ -49,7 +50,7 @@ The event is located at the **CDC Roybal Campus, Building 19, Auditorium B1/B2**
 |   `1:00` -    `4:50` | `Breakout rooms` | Hackathon Session 2 |
 |   `4:50` -    `5:00` | `Aud B1/B2` | Wrap-up and Announcements for Day 1 |
 
-**Day 2 - Thursday, October 4, 2018**
+##### Day 2 - Thursday, October 4, 2018
 
 | Time | Location | Description |
 | -------- | -------- | -------- |
@@ -74,5 +75,3 @@ The event is located at the **CDC Roybal Campus, Building 19, Auditorium B1/B2**
 1. **Is there anything I should know about getting onto the CDC Roybal campus?** We suggest getting a CDC decal for your car. If you don't have a decal, your vehicle may be subject to a search before it’s allowed onto the campus. Decals can be acquired at any guard desk.
 
 1. **How do I get in touch with the organizers?** Send an email to [[email protected]](mailto:[email protected]) with any questions, problems, or concerns. Members of several teams will also be on-site both days for hands-on assistance: The Accelerator Team (who are also the developers and maintainers of the Foundation Services), [OCIO](https://www.cdc.gov/od/ocio/), ITSO AHB engineers from the ECPaaS team, and the [Surveillance Data Platform](https://www.cdc.gov/sdp/index.html) team from [CSELS](https://www.cdc.gov/csels/index.html).
-
-

pages/about.html

@@ -6,7 +6,7 @@
 banner-heading: About
 banner-text: 
   - As the nation's health protection agency, CDC saves lives and protects people from health threats. We also strive to be open with our public health data sets, APIs and code repositories. By sharing CDC resources, we hope to foster innovation and increase the health security of our nation.
-  - CDC Open Technology is an open innovation program sponsored by CDC's Office of the Chief Information Officer. You can view more information on the organization <a href="https://www.cdc.gov/od/ocio/index.htm">here</a>.
+  - CDC Open Technology is an open innovation program sponsored by CDC's Office of the Chief Information Officer. You can view more information on the organization <a href="https://www.cdc.gov/od/ocio/index.htm">here</a>. This site is open source. You can view the source and suggest changes to add relevant open technology on <a href="https://github.com/cdcgov/opencdc">GitHub</a>.
 ---
 
 <div id="about">

pages/change.md

@@ -22,4 +22,21 @@ All resources described here are available to the public by CDC public health pr
 1. Provide a brief description of what you're proposing.
 1. Click "Create pull request."
 
-We'll confirm everything is accurate and once we confirm  your change, this site will update and make it available.
+We'll confirm everything is accurate and once we confirm  your change, this site will update and make it available.
+
+#### Example change
+
+Each of the open technology items is described by its metadata, and this metadata is used to autogenerate the html necessary for the item to show up in this site so people can find and use it.
+
+For example, if you wanted to add a new data set called "My Sample Data Server", you would open the [_data/apis.yml](https://github.com/CDCgov/opencdc/blob/master/_data/apis.yml) file, and add four new new lines for your new metadata item. Make sure to set values for all elements.
+
+```yml
+- title: Data.CDC.gov
+  id: data-cdc-gov
+  url: https://data.cdc.gov
+  tagline: "Data.CDC.gov is a repository..."
+- title: My Sample Data Server
+  id: some-unique-id-wont-be-displayed
+  url: https://urlto.my.server.com
+  tagline: "This tagline shows as the description for my new data set and will help users understand my data, so they can better use it."
+```

pages/search.md

@@ -14,6 +14,5 @@ category: search
   var searchData = {{ site.data.search | jsonify }};
 </script>
 
-
 <script src="{{ '/assets/js/lib/lunr.min.js' | prepend: site.baseurl  }}"></script>
 <script src="{{ '/assets/js/search.js' | prepend: site.baseurl  }}"></script>