Merge pull request #18 from nsidc/update-to-homepage-trey

Update to homepage - Trey's edits

Author: rmarow

CONTRIBUTING.md

@@ -1,20 +1,19 @@
 # Contributing
 
-## Authoring a post
+## Local development
 
-* Create a new directory for your post following existing directory structure
-  pattern
-    * Name the directory after your post
+First, create a local envirionment with `quarto` installed:
 
-* Name the markdown file containing your blog post `index.md`
-    * _Only_ name it `index.qmd` if the file is computational markdown, i.e.
-      contains executable code.
+```
+conda env create -f environment.yml
+conda activate nsidc-github-pages
+```
 
-* Populate markdown front-matter with metadata following pattern from existing
-  posts
-    * Include `title`, `description`, `author`, `date`, and `categories`
-      fields.
-    * Description should be a one-sentence introduction to the post.
+Next, startup the quarto development server:
 
-* Include any images or other assets that are specific to this post in the
-  post's directory
+```
+quarto preview
+```
+
+And finally, start developing content! Changes to content should get
+automatically updated in your browser.

README.md

@@ -1,6 +1,8 @@
-# NSIDC Github Web homepage 
+# NSIDC Github Pages
 
-This is landing page for NSIDC github websites.
+This is landing page for NSIDC [GitHub Pages](https://pages.github.com/)-based
+websites.
 
-The website is built in GitHub Actions by [Quarto](https://quarto.org/), a modern technical
-publishing tool. The website is deployed to GitHub Pages.
+The website is built in GitHub Actions by [Quarto](https://quarto.org/), a
+modern technical publishing tool. The website is deployed to [GitHub
+Pages](https://pages.github.com/).

environment.yml

@@ -1,4 +1,4 @@
-name: "nsidc-technical-blog"
+name: "nsidc-github-pages"
 channels:
   - "conda-forge"
   - "nodefaults"

index.md

@@ -1,8 +1,10 @@
 ---
-title: "NSIDC"
+title: "NSIDC GitHub Pages"
 ---
 
-Welcome to the NSIDC github websites home page.  
+Welcome to the NSIDC [GitHub Pages](https://pages.github.com/) home page. This site serves as a landing-page for all of NSIDC's GitHub Pages-hosted websites:
 
-## [NSIDC Data Cookbook](nsidc.github.io/NSIDC-Data-Cookbook/)  
-## [NSIDC Technical Blog](https://nsidc.github.io/NSIDC-Technical-Blog/) 
+* [NSIDC Data Cookbook](https://nsidc.github.io/NSIDC-Data-Cookbook/): A guide
+  to searching, accessing and working with NSIDC data.
+* [NSIDC Technical Blog](https://nsidc.github.io/NSIDC-Technical-Blog/): A blog
+  by and for NSIDC developers.