docs: create documentation site (#95)

Author: felangel

.github/workflows/deploy.yaml

@@ -0,0 +1,47 @@
+name: deploy
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    name: Deploy to GitHub Pages
+
+    runs-on: ubuntu-latest
+
+    defaults:
+      run:
+        working-directory: docs
+
+    steps:
+      - name: 📚 Git Checkout
+        uses: actions/checkout@v2
+
+      - name: ⚙️ Setup Node
+        uses: actions/setup-node@v3
+        with:
+          node-version: 16.x
+          cache: yarn
+          cache-dependency-path: docs/yarn.lock
+
+      - name: 📦 Install Dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: ✨ Check Format
+        run: yarn run format:check
+
+      - name: 🧹 Lint
+        run: yarn run lint
+
+      - name: 👷 Build website
+        run: yarn build
+
+      - name: ☁️ Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./build
+          user_name: github-actions[bot]
+          user_email: 41898282+github-actions[bot]@users.noreply.github.com

.github/workflows/docs.yaml

@@ -0,0 +1,34 @@
+name: docs
+
+on: pull_request
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    defaults:
+      run:
+        working-directory: docs
+
+    steps:
+      - name: 📚 Git Checkout
+        uses: actions/checkout@v2
+
+      - name: ⚙️ Setup Node
+        uses: actions/setup-node@v3
+        with:
+          node-version: 16.x
+          cache: yarn
+          cache-dependency-path: docs/yarn.lock
+
+      - name: 📦 Install Dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: ✨ Check Format
+        run: yarn run format:check
+
+      - name: 🧹 Lint
+        run: yarn run lint
+
+      - name: 👷 Build website
+        run: yarn build

docs/.eslintrc.js

@@ -0,0 +1,12 @@
+/**
+ * @type {import('@types/eslint').Linter.BaseConfig}
+ */
+module.exports = {
+  extends: ['plugin:@docusaurus/recommended'],
+  plugins: ['@docusaurus'],
+  parserOptions: {
+    ecmaVersion: 'latest',
+    sourceType: 'module',
+  },
+  parser: '@babel/eslint-parser',
+};

docs/.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

docs/.prettierignore

@@ -0,0 +1,5 @@
+node_modules
+/build
+/public/build
+.env
+.docusaurus

docs/.prettierrc

@@ -0,0 +1,3 @@
+{
+  "singleQuote": true
+}

docs/README.md

@@ -0,0 +1,25 @@
+# 📚 Dart Frog Site
+
+This website is built using [Docusaurus 2](https://docusaurus.io/), a modern static website generator.
+
+### ⚙️ Installation
+
+```
+yarn install
+```
+
+### 🧑‍💻 Local Development
+
+```
+yarn start
+```
+
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+
+### 📦 Build
+
+```
+yarn build
+```
+
+This command generates static content into the `build` directory and can be served using any static contents hosting service.

docs/babel.config.js

@@ -0,0 +1,3 @@
+module.exports = {
+  presets: [require.resolve('@docusaurus/core/lib/babel/preset')],
+};

docs/docs/basics/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "Basics 📚",
+  "position": 2,
+  "link": {
+    "type": "generated-index",
+    "description": "5 minutes to learn the most important Dart Frog concepts."
+  }
+}

docs/docs/basics/congratulations.md

@@ -0,0 +1,25 @@
+---
+sidebar_position: 6
+---
+
+# Congratulations! 🎉
+
+You have just learned the **basics of Dart Frog**.
+
+## Additional Resources 📚
+
+- [Example][example_link]
+- [Roadmap][roadmap_link]
+- [Blog post][blog_link]
+- [Livestream demo][livestream_link]
+
+:::info
+Did you know the [dart2js][dart2js_compiler_link] compiler [used to be called frog][dart2js_frog_pr_link]?
+:::
+
+[blog_link]: https://verygood.ventures/blog/dart-frog
+[dart2js_compiler_link]: https://dart.dev/tools/dart2js
+[dart2js_frog_pr_link]: https://github.com/dart-lang/sdk/issues/2194
+[example_link]: https://github.com/VeryGoodOpenSource/dart_frog/tree/main/example
+[livestream_link]: https://youtu.be/N7l0b09c6DA
+[roadmap_link]: https://github.com/VeryGoodOpenSource/dart_frog/blob/main/ROADMAP.md