fix: links

fix: intro link

feat: upgraded docs

fix: top level pages

fix: double headers

fix: dir cleanup

feat: update migration doc

fix: dir and markdown

fix: getting started docs

fix: tweaks to docstrings

fix: add root docs

fix: test md migration

fix: docs workflows

feat: new docs and updates

fix: workflows

fix: push not merge