Documentation Sites
Serve a top-level Knowledge Base section as a public documentation site anyone can read without signing in, one site per product: create it, switch it on, give its visitors Ask AI, rebuild or delete it, and share one article onto more than one site.
On this page
What a documentation site is#
A documentation site is a public website built from your Knowledge Base. Each top-level category of your Knowledge Base can become a site of its own, so you can run one site per product. The category's subcategories become the site's sections, and its published, customer-facing articles become its pages. Anyone can read a site that is switched on, without signing in.
This is different from the customer Help center, which only signed-in portal customers can read.
You write and edit the pages in the Knowledge Base as usual. Every change to a public page rebuilds the site within about a minute.
Who can manage sites#
Sites are managed under Configure Settings → Knowledge Base → Documentation Sites. You need the Manage documentation sites permission, which every admin role holds. Your organization's own admins create, switch on, rebuild and delete sites; nobody at DevStride needs to be involved. See Knowledge Base permissions.
Create a site#
- Open Configure Settings → Knowledge Base → Documentation Sites. If you already have a site, click Add another site.
- Choose the Knowledge Base category: a top-level category that is not already a site and does not hold specs. You cannot change it afterwards.
- Enter a Site name. It becomes the first part of the site's address, so use lowercase letters, digits and hyphens (3 to 63 characters). Names are first come, first served across every DevStride organization, and some names (such as
www,api,helporsupport) are reserved. - Enter a Title, shown in the site's header.
- Decide whether visitors may ask AI about its pages (below). This starts off.
- Click Create site.
A new site starts switched off: nothing is public yet.
Switch a site on or off#
Turn on Serve this site publicly to publish the site's pages at its address. Turn it off to take them down.
A site cannot be switched on while its top-level category is set to Internal. Change the category to Portal (customers) in the Knowledge Base first.
Below the switch, the page counts the site's pages (published, drafts, and how many are public) and lists any published page the site would not serve, with the reason: for example, the article is internal, a category above it is internal, it is a spec, or it is shared with a limited audience.
You can change a site's Title at any time. Its Site name can only be changed while the site is switched off, because the name is part of every page's public address.
Let visitors ask AI#
Turn on Let visitors ask AI about these pages and visitors can type a question and get an answer written from that site's public pages, with links to them. It is chosen per site and starts off on every new site. Sites that already offered Ask AI keep it.
Answers on all of your organization's sites count toward one monthly limit for your organization, which DevStride sets.
Rebuild or delete a site#
The Public files card shows the site's last build. Rebuild now rewrites every file, for example after the page design has changed.
Delete site removes the site, its addresses and its redirects. Its articles stay in the Knowledge Base.
Suspended sites#
DevStride staff can suspend a site. A suspended site is switched off and you cannot switch it on; the settings page says so. Contact DevStride support. When the suspension is lifted the site stays off until you switch it on.
Show one article on more than one site#
An article belongs to the site of the top-level category it is filed under. To show it on another site as well, open it in the article editor and use Also shown on: choose Share onto another site… and pick the category on the other site where it should appear.
- You still edit the article in one place, and every edit shows on every site.
- Each site shows it at its own address.
- The copy on the article's own site is the original, and the other sites tell search engines so.
- Remove a site from Also shown on to take the article off that site. Its old address is remembered.
Sharing an article onto another site adds a public page there at once when the article and its own categories are customer-facing. You need Publish knowledge-base articles to share, move or remove a copy.