Add visuals to the documentation

[frewsxcv]

Adding visuals to the documentation could be helpful for people like me who have trouble focusing on big blocks of text. Some examples I'm thinking:

• Add a basic visual for each geometry type we offer (Shapely does this)
• When appropriate, add a visual for each algorithm. For example, it's come up a couple times how Extremes and BoundingRect differ (happened to me once too), and I think a visual would really help here

As for the how, here's the code for how Shapely generates their visuals: https://github.com/Toblerity/Shapely/tree/master/docs/code

I was thinking we can create a new repo in the GeoRust org called 'diagrams' (or 'visuals' or reuse the existing 'static' repo) that would include both the code to generate the visuals, and also host them via GitHub pages.

[urschrei]

+100000 to this

[Nevsden]

• Add a basic visual for each geometry type we offer (Shapely does this)

As for the how, here's the code for how Shapely generates their visuals: https://github.com/Toblerity/Shapely/tree/master/docs/code

As you mention Shapely, do you have in mind a particular programming language to add this functionality or could Rust also be considered? I found the kiss3d quite easy to use and with enough functionality to support line / polygon drawing on a simple birds-eye view.

[frewsxcv]

• Add a basic visual for each geometry type we offer (Shapely does this)

As for the how, here's the code for how Shapely generates their visuals: https://github.com/Toblerity/Shapely/tree/master/docs/code

As you mention Shapely, do you have in mind a particular programming language to add this functionality or could Rust also be considered? I found the kiss3d quite easy to use and with enough functionality to support line / polygon drawing on a simple birds-eye view.

My thinking is Rust would be preferred for this. But if that's a pain or the tooling isn't mature enough, then another language like Python is acceptable

[frewsxcv]

rust-lang/rust#32104 (comment)

[dabreegster]

I'm messing around in https://github.com/dabreegster/georust-tester with an idea for a small web app that lets you fiddle with geometry in MapLibre, then interactively call georust APIs through WASM. If the initial idea proves useful, I'd be happy to figure out how to embed these in the docs or link to them.

[frewsxcv]

@dabreegster I finally took a look and this is really promising! I think it's worth moving forward with experimenting with adding an <iframe> to your examples in the documentation, and then we can evaluate next steps then.