From ceb311dd639758c5e8cf5ae53c381944fdc14cdb Mon Sep 17 00:00:00 2001
From: edmcquinn <73904683+edmcquinn@users.noreply.github.com>
Date: Wed, 10 Jan 2024 16:28:18 -0500
Subject: [PATCH] Initial commit
---
.github/workflows/preview-docs.yml | 52 ++++++++++++
.github/workflows/publish-docs.yml | 44 ++++++++++
README.md | 115 +++++++++++++++++++++++++++
fern/definition/actor.yml | 38 +++++++++
fern/definition/api.yml | 7 ++
fern/definition/movie.yml | 103 ++++++++++++++++++++++++
fern/docs.yml | 33 ++++++++
fern/docs/assets/favicon.ico | Bin 0 -> 15406 bytes
fern/docs/assets/logo_dark_mode.png | Bin 0 -> 49109 bytes
fern/docs/assets/logo_light_mode.png | Bin 0 -> 63607 bytes
fern/docs/pages/sdks.mdx | 44 ++++++++++
fern/docs/pages/welcome.mdx | 96 ++++++++++++++++++++++
fern/fern.config.json | 4 +
fern/generators.yml | 23 ++++++
14 files changed, 559 insertions(+)
create mode 100644 .github/workflows/preview-docs.yml
create mode 100644 .github/workflows/publish-docs.yml
create mode 100644 README.md
create mode 100644 fern/definition/actor.yml
create mode 100644 fern/definition/api.yml
create mode 100644 fern/definition/movie.yml
create mode 100644 fern/docs.yml
create mode 100644 fern/docs/assets/favicon.ico
create mode 100644 fern/docs/assets/logo_dark_mode.png
create mode 100644 fern/docs/assets/logo_light_mode.png
create mode 100644 fern/docs/pages/sdks.mdx
create mode 100644 fern/docs/pages/welcome.mdx
create mode 100644 fern/fern.config.json
create mode 100644 fern/generators.yml
diff --git a/.github/workflows/preview-docs.yml b/.github/workflows/preview-docs.yml
new file mode 100644
index 0000000..ad753be
--- /dev/null
+++ b/.github/workflows/preview-docs.yml
@@ -0,0 +1,52 @@
+name: fern
+
+on: pull_request
+
+jobs:
+ check:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout repository
+ uses: actions/checkout@v4
+
+ - name: Setup Node.js
+ uses: actions/setup-node@v4
+ with:
+ node-version: "18"
+
+ - name: Install Fern
+ run: npm install -g fern-api
+
+ - name: Validate API configuration
+ run: fern check
+
+ preview-docs:
+ needs: check
+ runs-on: ubuntu-latest
+ permissions: write-all
+ steps:
+ - name: Checkout repository
+ uses: actions/checkout@v4
+
+ - name: Setup Node.js
+ uses: actions/setup-node@v4
+ with:
+ node-version: "18"
+
+ - name: Install Fern
+ run: npm install -g fern-api
+
+ - name: Generate preview URL
+ id: generate-docs
+ env:
+ FERN_TOKEN: ${{ secrets.FERN_TOKEN }}
+ run: |
+ OUTPUT="$(fern generate --docs --preview)"
+ echo "Command Output: $OUTPUT"
+ URL=$(echo "$OUTPUT" | grep -oP 'Published docs to \K.*(?= \()')
+ echo "Preview your docs: $URL" > preview_url.txt
+
+ - name: Comment URL in PR
+ uses: thollander/actions-comment-pull-request@v2.4.3
+ with:
+ filePath: preview_url.txt
diff --git a/.github/workflows/publish-docs.yml b/.github/workflows/publish-docs.yml
new file mode 100644
index 0000000..f72653d
--- /dev/null
+++ b/.github/workflows/publish-docs.yml
@@ -0,0 +1,44 @@
+name: fern
+
+on:
+ push:
+ branches:
+ - main
+
+jobs:
+ check:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout repository
+ uses: actions/checkout@v4
+
+ - name: Setup Node.js
+ uses: actions/setup-node@v4
+ with:
+ node-version: "18"
+
+ - name: Install Fern
+ run: npm install -g fern-api
+
+ - name: Validate API configuration
+ run: fern check
+
+ publish-docs:
+ needs: fern-check
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout repository
+ uses: actions/checkout@v4
+
+ - name: Setup Node.js
+ uses: actions/setup-node@v4
+ with:
+ node-version: "18"
+
+ - name: Install Fern
+ run: npm install -g fern-api
+
+ - name: Publish Docs
+ env:
+ FERN_TOKEN: ${{ secrets.FERN_TOKEN }}
+ run: fern generate --docs --log-level debug
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9522e2a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,115 @@
+
+
+
+
+
+
+
+
+# Docs Starter
+
+Create beautiful documentation in under 5 minutes. Here's [an example!](https://your-organization.docs.buildwithfern.com)
+
+[![Discord](https://img.shields.io/badge/Join%20Our%20Community-black?logo=discord)](https://discord.com/invite/JkkXumPzcG)
+
+
+
+---
+
+## Customer Showcase
+
+Your docs can look this good:
+
+- [Flatfile's API Reference](https://reference.flatfile.com/api-reference/events/create-an-event)
+- [Sugeragent's Docs](https://docs.superagent.sh/)
+- [Credal's Docs](https://docs.credal.ai/)
+
+---
+
+## Let's Get Started
+
+### Step 1: Use This Template
+
+1. Click on the "Use this template" button.
+2. Create a new repository. Name it anything you like, `docs` is a common naming choice.
+
+### Step 2: Open in Your Preferred IDE
+
+Clone your newly created repository and open it in your favorite integrated development environment (IDE) or code editor.
+
+### Step 3: Customize Organization Name
+
+In the fern.config.json file, replace the placeholder organization name with your actual organization name. For example:
+
+```json
+{
+ "organization": "YourOrganization",
+ "version": "0.16.25"
+}
+```
+
+Also, in the docs.yml file, update the docs URL to match your organization's naming convention. For example:
+
+```yml
+instances:
+ - url: your-organization.docs.buildwithfern.com
+```
+
+### Step 4: Generate Your Documentation
+
+1. Install the Fern CLI by running:
+
+```bash
+npm install -g fern-api
+```
+
+1. Generate your documentation with the following command:
+
+```bash
+fern generate --docs
+```
+
+You will be prompted to log in and connect your GitHub account.
+
+Once the documentation is generated, you will receive a URL where your documentation is published. For example:
+
+```shell
+┌─
+│ ✓ your-organization.docs.buildwithfern.com
+└─
+```
+
+### Step 5: Choose an API definition format
+
+If you're using a [Fern Definition](https://docs.buildwithfern.com/api-definition/fern-definition/overview), you can edit the files within the [`definition`](/fern/definition/) folder.
+
+If you're using an [OpenAPI Specification](https://docs.buildwithfern.com/api-definition/openapi/extensions), then run the command: `fern generate`. You'll see a new folder created called `openapi` that contains your spec. You can edit this spec to make it your own OR copy and paste a spec you already have. Then, delete the `definition` folder.
+
+### Step 6: Customize Your Documentation
+
+Next, modify the markdown pages located in the [pages](fern/docs/pages/) directory. You can further tailor your documentation to match your brand by adjusting settings in the [docs.yml](fern/docs.yml) file.
+
+Fern has a built-in component library for you to use. [Explore the components.](https://docs.buildwithfern.com/generate-docs/component-library/)
+
+### Step 6: Set Up a Custom Domain
+
+If you wish to use a custom domain like `docs.your-organization.com` or a subdirectory like `your-organization.com/docs`, you can subscribe to the [Starter plan](https://buildwithfern.com/pricing). Once subscribed, update [docs.yml](fern/docs.yml) with the custom domain configuration:
+
+``` yaml
+ - url: your-organization.docs.buildwithfern.com
+ custom-domain: docs.your-organization.com
+```
+
+### Step 7: Explore Advanced Features
+
+For advanced documentation features and options, visit the [Fern Docs](https://docs.buildwithfern.com/generate-docs).
+
+**Advanced features** include:
+
+- Versioning
+- Changelog
+- Multiple APIs
+- Custom background
+- Bring your own fonts
+
+Good luck creating beautiful and functional documentation! 🌿
diff --git a/fern/definition/actor.yml b/fern/definition/actor.yml
new file mode 100644
index 0000000..2df99a2
--- /dev/null
+++ b/fern/definition/actor.yml
@@ -0,0 +1,38 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/fern-api/fern/main/fern.schema.json
+
+imports:
+ movie: movie.yml
+
+service:
+ auth: false
+ base-path: /actors
+ endpoints:
+ listMovies:
+ display-name: List Movies for an Actor
+ docs: This endpoint will return a list of movies that Morgan Freeman (Actor ID `nm0000151`) has acted in. We'll list just 5 movies, because he's acted in over 153!
+ method: GET
+ path: /list-movies/{actorId}
+ path-parameters:
+ actorId: ActorId
+ response: list
+ examples:
+ - name: Morgan Freeman
+ path-parameters:
+ actorId: nm0000151
+ response:
+ body:
+ - "The Shawshank Redemption"
+ - "The Power of One"
+ - "Unforgiven"
+ - "Outbreak"
+ - "Se7en"
+
+types:
+ ActorId:
+ type: string
+ docs: The unique identifier for an actor in the database
+
+errors:
+ ActorDoesNotExistError:
+ status-code: 404
+ type: ActorId
diff --git a/fern/definition/api.yml b/fern/definition/api.yml
new file mode 100644
index 0000000..ad2a3c1
--- /dev/null
+++ b/fern/definition/api.yml
@@ -0,0 +1,7 @@
+name: imdb-api
+error-discrimination:
+ strategy: status-code
+auth: bearer
+environments:
+ Sandbox: https://sandbox.example.com
+default-environment: Sandbox
\ No newline at end of file
diff --git a/fern/definition/movie.yml b/fern/definition/movie.yml
new file mode 100644
index 0000000..b81eebf
--- /dev/null
+++ b/fern/definition/movie.yml
@@ -0,0 +1,103 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/fern-api/fern/main/fern.schema.json
+
+service:
+ auth: false
+ base-path: /movies
+ endpoints:
+ create:
+ docs: Add a movie to the database
+ display-name: Create a Movie
+ method: POST
+ path: /create-movie
+ request: CreateMovieRequest
+ response: MovieId
+ examples:
+ - name: Shawshank Example
+ request:
+ title: The Shawshank Redemption
+ rating: 9.3
+ response:
+ body: tt0111161
+
+ get:
+ docs: Retrieve a movie from the database based on the ID
+ display-name: Get a Movie by ID
+ method: GET
+ path: /{id}
+ path-parameters:
+ id: MovieId
+ response: Movie
+ errors:
+ - MovieDoesNotExistError
+ examples:
+ # Success response
+ - path-parameters:
+ id: tt9398640
+ response:
+ body:
+ id: tt9398640
+ title: "Between Two Ferns: The Movie"
+ rating: 6.1
+ year: "2019"
+ # Error response
+ - path-parameters:
+ id: tt1234
+ response:
+ error: MovieDoesNotExistError
+ body: tt1234
+
+ delete:
+ display-name: Delete a Movie by ID
+ method: DELETE
+ path: /{id}
+ path-parameters:
+ id: MovieId
+ examples:
+ - path-parameters:
+ id: tt2294629
+ errors:
+ - MovieDoesNotExistError
+
+ update:
+ display-name: Update a Movie by ID
+ method: PUT
+ path: /{id}
+ path-parameters:
+ id: MovieId
+ request: UpdateMovieRequest
+ examples:
+ - path-parameters:
+ id: tt2294629
+ request:
+ year: "2019"
+ errors:
+ - MovieDoesNotExistError
+types:
+ MovieId:
+ type: string
+ docs: The unique identifier for a movie in the database
+
+ Movie:
+ properties:
+ id: MovieId
+ title: string
+ rating:
+ type: double
+ docs: The rating scale out of ten stars
+ year: string
+
+ CreateMovieRequest:
+ properties:
+ title: string
+ rating: double
+
+ UpdateMovieRequest:
+ properties:
+ title: optional
+ rating: optional
+ year: optional
+
+errors:
+ MovieDoesNotExistError:
+ status-code: 404
+ type: MovieId
diff --git a/fern/docs.yml b/fern/docs.yml
new file mode 100644
index 0000000..2cf121e
--- /dev/null
+++ b/fern/docs.yml
@@ -0,0 +1,33 @@
+instances:
+ - url: your-organization.docs.buildwithfern.com
+
+title: Your Organization | Docs
+
+navigation:
+ - section: Getting started
+ contents:
+ - page: Welcome
+ path: ./docs/pages/welcome.mdx
+ - page: SDKs
+ path: ./docs/pages/sdks.mdx
+ - api: API Reference
+
+navbar-links:
+ - type: secondary
+ text: Contact us
+ url: "mailto:support@buildwithfern.com"
+ - type: primary
+ text: Join the Discord
+ url: https://discord.com/invite/JkkXumPzcG
+
+colors:
+ accentPrimary:
+ dark: "#adff8c"
+ light: "#376d20"
+
+logo:
+ dark: ./docs/assets/logo_dark_mode.png
+ light: ./docs/assets/logo_light_mode.png
+ height: 30
+
+favicon: ./docs/assets/favicon.ico
\ No newline at end of file
diff --git a/fern/docs/assets/favicon.ico b/fern/docs/assets/favicon.ico
new file mode 100644
index 0000000000000000000000000000000000000000..c3dda249389def5374caa9272803efcaab23af93
GIT binary patch
literal 15406
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
literal 0
HcmV?d00001
diff --git a/fern/docs/assets/logo_dark_mode.png b/fern/docs/assets/logo_dark_mode.png
new file mode 100644
index 0000000000000000000000000000000000000000..7d8d91afa2a0eeb2921f5a847fb393ab93e2d800
GIT binary patch
literal 49109
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