Skip to content
DocSpadedocspade

Tutorial: publish your first documentation site

In this tutorial you will go from nothing to a live documentation site with one article. It takes about fifteen minutes.

You will:

  1. Create an organization
  2. Create a space and a knowledge base
  3. Write and review an article
  4. Add it to the navigation
  5. Publish the site

By the end you will have a site at a web address you can share.

What you need

An email address you can open.

1. Create your organization

  1. Open DocSpade and select Register.
  2. Select the Organization tab.
  3. Enter your email, an organization name such as Acme Docs, and a password of at least 8 characters.
  4. Select Create account.
  5. Open the confirmation email and select the link, then sign in.

You are now the owner of the organization.

2. Create a space and a knowledge base

A space groups related documentation, and a knowledge base is one documentation site inside it.

  1. Select Configuration in the top navigation, then select your organization in the list on the left.
  2. Select Create space, enter the name Product, and select Create space.
  3. Select the Product space in the list, then select Create knowledge base.
  4. Enter the name User guide, leave Initial style policy on Inherit space policy, and select Create knowledge base.

You will see the knowledge base under your space.

3. Write an article

  1. Select Authoring in the top navigation.
  2. Choose User guide in the Knowledge base list.
  3. Select the New document icon in the editor.
  4. Enter the title Get started and the slug get-started, then select Create article.
  5. In the editor, write a few sentences, for example a heading called Welcome and a paragraph about what your product does.

4. Review it

  1. In the review panel on the right, open the Style review tab and select Review content.
  2. Look at the findings. If one has an OK button, select it to accept the recommended change.

You can skip any finding you disagree with. A review never blocks you.

5. Save it for publishing

  1. Select Save, then Publish.

You will see Article published. The article is now ready for the next site update. Readers cannot see it yet.

6. Add it to the navigation

  1. In the Navigation panel, select Add to navigation, then Current article.
  2. Select Save navigation.

The panel shows Nav saved.

7. Publish the site

  1. Select Publish site at the bottom of the Navigation panel.

DocSpade builds your site and switches to it when it is ready.

8. Visit your site

Open this address, replacing the parts in angle brackets with the names (slugs) shown in the Configuration list:

https://<organization>.docspade.com/<space>/<knowledge-base>/

You should see your Get started article.

What you have learned

You created an organization, a space and a knowledge base, wrote and reviewed an article, saved it for publishing, put it in the navigation, and published a site.

Where to go next

Was this page helpful?

Powered by Docspade © 2026