privateGPT/fern/README.md
Javier Martinez 4523a30c8f
feat(docs): update documentation and fix preview-docs (#2000)
* docs: add missing configurations

* docs: change HF embeddings by ollama

* docs: add disclaimer about Gradio UI

* docs: improve readability in concepts

* docs: reorder `Fully Local Setups`

* docs: improve setup instructions

* docs: prevent have duplicate documentation and use table to show different options

* docs: rename privateGpt to PrivateGPT

* docs: update ui image

* docs: remove useless header

* docs: convert to alerts ingestion disclaimers

* docs: add UI alternatives

* docs: reference UI alternatives in disclaimers

* docs: fix table

* chore: update doc preview version

* chore: add permissions

* chore: remove useless line

* docs: fixes

...
2024-07-18 10:06:51 +02:00

1.4 KiB

Documentation of PrivateGPT

The documentation of this project is being rendered thanks to fern.

Fern is basically transforming your .md and .mdx files into a static website: your documentation.

The configuration of your documentation is done in the ./docs.yml file. There, you can configure the navbar, tabs, sections and pages being rendered.

The documentation of fern (and the syntax of its configuration docs.yml) is available there docs.buildwithfern.com.

How to run fern

You cannot render your documentation locally without fern credentials.

To see how your documentation looks like, you have to use the CICD of this repository (by opening a PR, CICD job will be executed, and a preview of your PR's documentation will be deployed in vercel automatically, through fern).

The only thing you can do locally, is to run fern check, which check the syntax of your docs.yml file.

How to add a new page

Add in the docs.yml a new page, with the following syntax:

navigation:
  # ...
  - tab: my-existing-tab
    layout:
      # ...
      - section: My Existing Section
        contents:
          # ...
          - page: My new page display name
            # The path of the page, relative to `fern/`
            path: ./docs/pages/my-existing-tab/new-page-content.mdx