Improve documentation structure

[andypbarrett]

This is the start of reorganizing and completing the documentation for earthaccess.

I have reorganized the first page of the docs to show a bare-bones example of authentication, granule search and download, to get people started.

I will focus on user-guides for the API methods starting with:

• login
• search_datasets
• search_data
• download
• open

---

📚 Documentation preview 📚: https://earthaccess--498.org.readthedocs.build/en/498/

[mfisher87]

Decisions from hack day;

• Break up the “Welcome” page to multiple pages
• Remove/summarize/link to license/LoS info
• Glossary -> User Guide Overview

[botanical]

Love the syntax highlighting in the code blocks ✨ As far as I can tell, these changes seem solid to me. Thanks for tagging for review 😄 Hopefully someone else can review it as well!

[mfisher87]

All, @asteiker asked for a chance to review, please hold off on merging until then.

[asteiker]

@andypbarrett I have quite a few comments here, most of which are nits. I think most are fairly quick (typos and smaller suggestions) but if there's anything that requires more discussion, I don't feel it warrants a hold on the merge. Happy to pull comments out into a new Issue(s) - lmk either way.

[asteiker]

Do we view the Discussions as our project board? I'm wondering if we want to describe this more like:

Discussion topics, including new feature ideas, announcements, and Q&A can be found in our Discussions.

Separately, I'm wondering if there's interest in building out a Roadmap and community project board for earthaccess. If so we could build it and add to the readme here!

[mfisher87]

I wonder if that was a copy-paste mistake?

[andypbarrett]

@mfisher87 If not discussions, what should it be? Issues?

[asteiker]

Also @andypbarrett @MattF-NSIDC These restructured docs are really fantastic - this is excellent work!! The organization is much improved and it really feels like the scaffolding is in place to easily build and continue to improve from here.