Sign Up

Uploading documentation to Doctave

In order to publish your documentation, you have to upload it for Doctave to host. We make it easy for you to publish your documentation either automatically from your CI/CD pipeline, or on an ad-hoc basis.

uploading your documentation

Upload methods

When creating your site in the Doctave dashboard you will choose an upload method for your site.

There are two ways to upload your documentation to Doctave:

The upload script is great for docs-as-code and production deployments and CI/CD, while drag-and-drop works well for testing and getting familiar with Doctave.

Upload methods are tied to a particular version. For example, you can have a customer-facing main version using the upload script, and an experimental test version using the drag-and-drop method in the same site.

You can change your upload method at any time.

Upload Script

The Doctave upload script is the preferred way to upload your documentation:

Running the Doctave script
# Ensure you're in the same directory as your doctave.yaml file
cd /path/to/my/project

# Invoke the upload script
curl -L -s | bash -s -- .

The script will:

  • Check Git which branch and commit you are on
  • Bundle up your documentation
  • Send it to Doctave along with the commit information

Once Doctave receives your documentation, it will create a build for the new revision of the content.

Upload tokens

In order for Doctave to know which site your content belongs to, each site has a unique upload token.

When you execute the script, you need to ensure it's available in your terminal's environment:

export DOCTAVE_UPLOAD_TOKEN="<your site's token>"

Finding your upload token

Your upload token can be found in your site's settings in the Doctave dashboard.

  1. Go to your sites
  2. Click on "Configure" for your site
  3. Click on "Settings" in the left site navigation

Your upload token can be revealed by clicking the input field.

screenshot of the Doctave dashboard pointing to where the upload token can be found

Drag and drop manual upload

The easiest way to upload your documentation is by dragging and dropping your project directory into the Doctave dashboard. This is useful if you want to experiment with a project that's not in a Git repository. However, Doctave recommends using Git for production environments.

When using the drag-and-drop upload method, you can drag the folder from your computer into the Doctave dashboard, and Doctave will create a new build from the files.

NOTE! Git branches and commits aren't tracked when using this upload method. Use the upload script upload method if you want to track Git information across your documentation changes.

  1. Set your version to match manual uploads
  2. Navigate to your site's overview page
  3. Select the correct version from the version dropdown
  4. Drag and drop your project directory into the upload area

Drag and drop upload

Changing your upload method

We've a separate guide for upgrading from a drag-and-drop workflow to a Git-based workflow with the upload script: changing from drag-and-drop to the upload script ›

If you are currently using the upload script and want to change to the drag-and-drop method do the following steps:

  1. Go to your sites
  2. Click on "Configure" for your site
  3. Click on "Settings" in the left site navigation
  4. Select the Version you want to update the upload method for, or create a new version
  5. Select the "manual upload" method for this version

selecting the upload method for the version in the Doctave dashboard

Was this page helpful?