From 3b3858024f409b9db0f472b6a09167a341458b66 Mon Sep 17 00:00:00 2001 From: Matt Fisher Date: Fri, 19 Apr 2024 17:58:19 -0600 Subject: [PATCH] Split the README into a GitHub README and doc page Previously, the README file was symlinked into our docs. This led to a problem where we could only write links that worked within one of the two systems. Docs links need to be relative to the symlink to render correctly, and GitHub README links need to be relative to the original file to work correctly. --- README.md | 19 +++++-------------- docs/index.md | 12 +++++++++++- 2 files changed, 16 insertions(+), 15 deletions(-) mode change 120000 => 100644 docs/index.md diff --git a/README.md b/README.md index f0888a39..8eea0480 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# Welcome +# _earthaccess_

earthaccess, a python library to search, download or stream NASA Earth science data with just a few lines of code @@ -33,25 +33,16 @@

-## What is `earthaccess`? - `earthaccess` is a python library to **search for**, and **download** or **stream** NASA Earth science data with just a few lines of code. -Open science only reaches its full potential if we have easy-to-use workflows that facilitate research in an inclusive, efficient and reproducible way. Unfortunately —as it stands today— scientists and students alike face a steep learning curve adapting to systems that have grown too complex and end up spending more time on the technicalities of the tools, cloud and NASA APIs than focusing on their important science. - -During several workshops organized by [NASA Openscapes](https://nasa-openscapes.github.io/events.html), the need to provide easy-to-use tools to our users became evident. Open science is a collaborative effort; it involves people from different technical backgrounds, and the data analysis to solve the pressing problems we face cannot be limited by the complexity of the underlying systems. Therefore, providing easy access to NASA Earthdata regardless of the data storage location (hosted within or outside of the cloud) is the main motivation behind this Python library. - -The library is an open source community effort under an [MIT license](LICENSE.txt). We welcome contributions to improve `earthaccess`. Please see the [Contributing Guide](CONTRIBUTING.md) to learn how to get involved. - -***earthaccess*** handles authentication with [NASA's Earthdata Login (EDL)](https://urs.earthdata.nasa.gov), search using NASA's [CMR](https://cmr.earthdata.nasa.gov/search/site/docs/search/api.html) and access through [`fsspec`](https://github.com/fsspec/filesystem_spec). +Visit [our documentation](https://earthaccess.readthedocs.io/en/latest) to learn more! Try it in your browser without installing anything! [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/nsidc/earthaccess/main) - ## How to Get Started with `earthaccess` -Go to the [Quick Start](quick-start.md) to learn how to install and see a simple example of using `earthaccess`. +Visit [our quick start guide](https://earthaccess.readthedocs.io/en/latest/quick-start.html) to learn how to install and see a simple example of using `earthaccess`. ## Compatibility @@ -61,10 +52,10 @@ Only **Python 3.8+** is supported. ## How to Contribute to `earthaccess` -If you want to find out how to contribute to `earthaccess` checkout the [Contributing Guide](CONTRIBUTING.md). +If you want to find out how to contribute to `earthaccess` checkout the [Contributing Guide](https://earthaccess.readthedocs.io/en/latest/contributing/). -## Contributors +### Contributors [![Contributors](https://contrib.rocks/image?repo=nsidc/earthaccess)](https://github.com/nsidc/earthaccess/graphs/contributors) diff --git a/docs/index.md b/docs/index.md deleted file mode 120000 index 32d46ee8..00000000 --- a/docs/index.md +++ /dev/null @@ -1 +0,0 @@ -../README.md \ No newline at end of file diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 00000000..9e116b31 --- /dev/null +++ b/docs/index.md @@ -0,0 +1,11 @@ +# What is `earthaccess`? + +`earthaccess` is a python library to **search for**, and **download** or **stream** NASA Earth science data with just a few lines of code. + +Open science only reaches its full potential if we have easy-to-use workflows that facilitate research in an inclusive, efficient and reproducible way. Unfortunately —as it stands today— scientists and students alike face a steep learning curve adapting to systems that have grown too complex and end up spending more time on the technicalities of the tools, cloud and NASA APIs than focusing on their important science. + +During several workshops organized by [NASA Openscapes](https://nasa-openscapes.github.io/events.html), the need to provide easy-to-use tools to our users became evident. Open science is a collaborative effort; it involves people from different technical backgrounds, and the data analysis to solve the pressing problems we face cannot be limited by the complexity of the underlying systems. Therefore, providing easy access to NASA Earthdata regardless of the data storage location (hosted within or outside of the cloud) is the main motivation behind this Python library. + +The library is an open source community effort under an [MIT license](LICENSE.txt). We welcome contributions to improve `earthaccess`. Please see the [Contributing Guide](contributing/index.md) to learn how to get involved. + +***earthaccess*** handles authentication with [NASA's Earthdata Login (EDL)](https://urs.earthdata.nasa.gov), search using NASA's [CMR](https://cmr.earthdata.nasa.gov/search/site/docs/search/api.html) and access through [`fsspec`](https://github.com/fsspec/filesystem_spec).