doc: generate documentation from examples

[mfazekas]

1. Move to docosaurus for documentation, instead of wiki (https://github.com/rnmapbox/maps-docs)
2. Use detox to generate screenshots of examples
3. Generate .md files from example metadata

The documentation generation looks like this:

1. Create docs/examples.json from metadata in examples.

   cd example
   npx jest __tests__/dumpExamplesJson.ts
   

2. Grab screenshots from examples (uses docs/examples.json and produces maps-docs/example-screenshots/screenshots.json)

   yarn detox build --configuration ios.debug
   yarn detox test --configuration ios.debug ./e2e/docScreenshots.e2e.js
   

3. Generate component/api documentation (into the docosaurus site). Reads docs/docs.json and produces maps-docs/docs/Components

   node scripts/doc-generate.mjs
   

4. Generate example docs (into the docosaurus site) maps-docs/docs/Examples

   bun scripts/example-docs.ts
   

5. Publish doc site

   cd ../maps-docs
   GIT_USER=mfazekas yarn deploy
   

[cameronmurphy]

I'm finding that the addition of jest.useFakeTimers() is causing my async tests to timeout. As a workaround, I've had to add jest.useRealTimers() to my own setupFilesAfterEnv script that runs after @rnmapbox/maps/setup-jest. Was this intentional?

https://github.com/rnmapbox/maps/pull/3108/files#diff-2613a6cc900c0e86674e9d8e44588694da45ef075ec9835dba871ece6c161894R5

[mfazekas]

@cameronmurphy good point, I don't think it's needed. Can you add a PR removing that?