diff --git a/README.md b/README.md index d46d23a..1bc49e2 100644 --- a/README.md +++ b/README.md @@ -21,6 +21,7 @@ Here's [an example.](https://docs.propexo.com/documentation) - Node 18 or higher - A [GitHub](https://github.com) account +- Familiarity with using a CLI --- @@ -44,16 +45,13 @@ The `fern/` folder in your repository contains these files and folders: ├─ store.yml └─ user.yml ├─ docs/ - ├─ assets/ - ├─ favicon.png - ├─ logo_dark_mode.png - └─ logo_light_mode.png + └─ assets/ └─ pages/ + ├─ concepts.mdx ├─ sdks.mdx └─ welcome.mdx - ├─ docs.yml -├─ fern.config.json -└─ generators.yml +├─ docs.yml +└─ fern.config.json ``` The `definition/` folder contains Fern Definition files for a sample API called Swagger Petstore. Fern uses these files to generate the API Reference section of your docs site. @@ -90,7 +88,6 @@ Install the Fern CLI tool globally by running: npm install -g fern-api ``` -When prompted, log into and connect your GitHub account. > [!NOTE] > The above CLI command is a global command that you can run from any location. The `fern` commands in the following steps must be run from within your repository. @@ -99,10 +96,12 @@ When prompted, log into and connect your GitHub account. Run the following command: -```bash +```shell fern generate --docs ``` +When prompted, log into and connect your GitHub account. + Once the documentation is generated, Fern displays the URL where you can view the published documentation. For example: ```shell @@ -137,11 +136,11 @@ To learn about Fern's built-in component library you can use in Markdown: ### Step 7: Set up a custom domain -If you wish to use a custom subdomain like `https://docs.YOUR_ORGANIZATION.com` or a subpath like `https://YOUR_ORGANIZATION.com/docs`, you can subscribe to the [Starter plan](https://buildwithfern.com/pricing). Once subscribed, update `docs.yml` with the custom domain configuration, replacing YOUR_ORGANIZATION with your own. +If you wish to use a custom subdomain like `https://docs.YOUR_ORGANIZATION.COM` or a subpath like `https://YOUR_ORGANIZATION.COM/docs`, you can subscribe to the [Starter plan](https://buildwithfern.com/pricing). Once subscribed, update `docs.yml` with the custom domain configuration, replacing YOUR_ORGANIZATION with your own: ```yaml - url: YOUR_ORGANIZATION.docs.buildwithfern.com - custom-domain: docs.YOUR_ORGANIZATION.com + custom-domain: docs.YOUR_ORGANIZATION.COM ``` Good luck creating beautiful and functional documentation! 🌿