Merge pull request #273 from nsidc/search-improvements

updating docs

.github/workflows/documentation.yml

@@ -4,7 +4,6 @@ on:
   push:
     branches:
       - main
-      - dev
       - documentation
     paths:
       - earthaccess/**
@@ -26,9 +25,15 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
+      - name: Set up Python
+        id: setup-python
+        uses: actions/setup-python@v2
+        with:
+          python-version: 3.9
       - name: Install and configure Poetry
         uses: snok/install-poetry@v1
         with:
+          version: 1.5.1
           virtualenvs-create: true
           virtualenvs-in-project: false
           virtualenvs-path: .venv
@@ -38,12 +43,13 @@ jobs:
         id: cache
         with:
           path: .venv
-          key: venv-${{ runner.os }}-${{ steps.full-python-version.outputs.version }}-${{ hashFiles('**/poetry.lock') }}
+          key: venv-${{ steps.setup-python.outputs.python-version }}-${{ hashFiles('**/poetry.lock') }}
       - name: Ensure cache is healthy
         if: steps.cache.outputs.cache-hit == 'true'
         run: poetry run pip --version >/dev/null 2>&1 || rm -rf .venv
       - name: Install Dependencies
-        run: poetry install
+        if: steps.cache.outputs.cache-hit != 'true'
+        run: poetry install --no-interaction
       - name: Build docs
         run: poetry run bash scripts/build-docs.sh
         env:
@@ -52,8 +58,8 @@ jobs:
 
       - name: Deploy
         if: |
-          github.event_name != 'push'
-          && github.ref == 'refs/heads/main'
+          github.event_name == 'push'
+          && (github.ref == 'refs/heads/main' || github.ref == 'ref/heads/documentation')
           && github.repository == 'nsidc/earthaccess'
         uses: peaceiris/actions-gh-pages@v3
         with:

.github/workflows/test.yml

@@ -22,7 +22,7 @@ jobs:
     steps:
       - uses: actions/checkout@v2
       - name: Set up Python
-        uses: actions/setup-python@v1
+        uses: actions/setup-python@v2
         with:
           python-version: ${{ matrix.python-version }}
       - name: Get full python version

binder/environment-dev.yml

@@ -9,6 +9,7 @@ dependencies:
 - xarray>=0.19
 - ipyleaflet>=0.13
 - h5netcdf>=0.11
+- cartopy
 - pip
 - pip:
   - poetry

binder/environment.yml

@@ -15,4 +15,6 @@ dependencies:
 - geopandas>=0.9
 - zarr>=2.9.5
 - jupyterlab>=3
-- poetry
+- hvplot
+- holoviews
+- panel

docs/tutorials/authenticate.md → docs/howto/authenticate.md

@@ -1,6 +1,8 @@
 ## Authenticate with Earthdata Login
 
-earthaccess can use environment variables, `.netrc` file or interactive input from a user to login with NASA EDL.
+The first step to use NASA Earthdata is to create an account with Earthdata Login, please follow the instructions at [NASA EDL](https://urs.earthdata.nasa.gov/)
+
+Once registered, earthaccess can use environment variables, a `.netrc` file or interactive input from a user to login with NASA EDL.
 
 If a strategy is not especified, env vars will be used first, then netrc and finally user's input.