More docs updates

[bollwyvl]

References

• follow-up on Overhaul docs toolchain #3673
  • thanks @jtpio re piplite path Overhaul docs toolchain #3673 (comment)

Changes

• fix jupyterlite wheel paths
• update branch references: master -> main
• try to fix binder workflow (haven't seen it re-run yet, because it only fires on pull_request_opened)
• look at some more sphinx warnings
• restore full index sidebar
• rework demo links (less bs (ha!))

[bollwyvl]

Modulo not knowing if this will fix the binder badge workflow, this is ready for review (and 🎃 merge is again fine).

[agoose77]

These changes are all fantastic.

Minor points:

• For me, the button icons are misaligned
  
• Personally I prefer API Reference to Reference
• I'd be tempted to move the try buttons to the index page only, maybe as a card?
• On Awkward Array, we have a quick-links card that might be similarly useful (maybe without the badges for ipywidgets) https://awkward-array.org/doc/main/

[bollwyvl]

button icons are misaligned

the first two are actually radios, was trying to "act like a local" and use bootstrap sugar. I'll try a treatment without.

move the try buttons to the index page only,

Could move to the bottom. Actually, it would be lovely to have a sidebar that was "open in lite," next to "edit in github".

API Reference to Reference

I'm just working off the upstream language guidance. There might be things there other than the API at some point, though can't tell what those would be.

[bollwyvl]

[agoose77]

Much better!!

[jasongrout]

Thanks!

[bollwyvl]

Cool. I think that's all the high-value stuff that wouldn't require a new release of something.

[jasongrout]

Cool. I think that's all the high-value stuff that wouldn't require a new release of something.

Thanks again for the massive amount of overhauling you did!