Rewrite geo crate documentation.

[frewsxcv]

• I agree to follow the project's code of conduct.
• I added an entry to CHANGES.md if knowledge of this change could be valuable to users.

---

Extracted out of #576

[michaelkirk]

Seems like a big improvement!

[frewsxcv]

Should we keep the GeoJSON section?

[michaelkirk]

I'd wager almost everyone will want to use geo to operate on data derived outside of geo, so I think it's worth including and also simultaneously introducing the context of the geo-types crate.

Here's some off-the-cuff copy:

geojson, wkt, shapefile, and [other crates](#link to addendum with exhaustive list) which support geo-types allow you to use geo with your favorite spatial format (insert joke about shapefile).
...

Formats that support geo-types

• postgis
• flatgeobuffer
• https://github.com/georust/geozero
• any others???

It's a little tricky because it'd be nice to just gloss over the fact that geo-types exists for users of geo, but in reality, people using these formats may need to build the crate with --feature geo-types so it'd be good to prime them to look for the word geo-types in that crate's documentation.

[urschrei]

I'd wager almost everyone will want to use geo to operate on data derived outside of geo

This was my rationale for the original inclusion of the GeoJSON section. I think it's useful to try to explicitly point out the various components of the Geo ecosystem to people as early as possible rather than relying on them to figure it out using the context from the docs.

[urschrei]

Just two minor things, but this is a big improvement in clarity overall. Thank you for doing this 👏👏❤️

[frewsxcv]

@michaelkirk @urschrei How do those last few commits look? Very open to suggestions for the Ecosystem section I added

[michaelkirk]

@michaelkirk @urschrei How do those last few commits look? Very open to suggestions for the Ecosystem section I added

Copy looks good! Presumably you'll need to plug in actual URL's for the ecosystem links.

Thanks for working on this!

[frewsxcv]

Presumably you'll need to plug in actual URL's for the ecosystem links.

they're linked below. i don't see the markdown link reference feature i'm using used often and am happy to switch to inline links if people prefer that.

[michaelkirk]

they're linked below. i don't see the markdown link reference feature i'm using used often and am happy to switch to inline links if people prefer that.

My bad! I thought they were just place holders. I think the link reference is great.

[urschrei]

@michaelkirk @urschrei How do those last few commits look? Very open to suggestions for the Ecosystem section I added

Lgtm!

[frewsxcv]

bors r=michaelkirk,urschrei

[bors]

Build succeeded:

• ci result