[astro] Docs: Fix md rendering and build

[edivados]

PR Checklist

Please check if your PR fulfills the following requirements:

• Tests for the changes have been added (for bug fixes / features)

PR Type

What kind of change does this PR introduce?

• Bugfix
• Feature
• Code style update (formatting, local variables)
• Refactoring (no functional changes, no api changes)
• Build related changes
• CI related changes
• Documentation content changes
• infrastructure changes
• Other... Please describe:

What is the current behavior?

• .md pages not rendering
• build not working

What is the new behavior?

• .md pages rendering
• build works

Other information

Astro includes a plugin astro:markdown that when removed seems to solve the rendering problem.
Maybe it is better to do the removal in the start package.

There are some twoslash errors on the following pages. (All should disappear with #919)

• core-concepts/state-management.mdx
• api/createRouteAction.md
• api/server.md

Build

Looks like entry-server.tsx and entry-client.tsx are being picked up as routes and because of this the generated dist/chunks/pages/handler.js makes calls to uninitialized stuff. Moved both files to src and changed appRoot and routesDir accordingly.

At first I tried moving all routes to a subdirectory docs/routes but this just broke navigation and fetch calls didn't return anything. Maybe you @ryansolid can give me some insight on this? The urls generated by the Nav compnent were wrong after moving the pages to docs/routes... 😑

[ryansolid]

Thank you