Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents

Instructions - Documentation

...

1. Theme

The theme used on our the documentation site is similar to the following theme.

Download the theme and change the colours to match your brand.

View file
nametheme-22-2020-03-26_13-19.zip

Alternatively, try out this fun theme we call “Radiant Theme”.

View file
nametheme-18-2020-03-26_18-22.zip

above is called ‘Radiant’ theme and comes included as a theme in the product.

2. Structure

The way you structure your site depends on your information heirarchyhierarchy. On our documentation site, each Refined app has a Confluence space home. We use the dropdown category structure to organize the apps into the Product Category.

...

For a documentation use case we typically see site homes with quick links to the product space homes (and general information pages), page links and activity feeds.

View and copy the layout below.

Expand
titleView a site home inspired by our own documentation site

Expand
titleView the site home layout inspired by our documentation site

Customizing the space layout

Note: Customization of a space and pages works differently in our Cloud app, Refined for Confluence.

Customize the space layout and save it as a template. Refined includes a space layout editor where you can customize the side bar on a space, the space home page and save it as a template. We recommend saving your commonly used space layouts as templates to save on maintenance. Click here for more info on space layout options.

For this documentation use case, Refined comes with a default “documentation” space layout you can select when creating a space, or edit and switch to it later. You can also customize your space to suit your needs.

...

4. Personalization

 To understand how to personalize your site and manage who can see what content go here: https://partners.refined.site/space/RFCS/246644781#4.-Personalization

Other ways to personalize a documentation site:

  • CQL in modules 

A really clever way to personalize your content is using CQL. For example you could show a users “favourite pages” (assuming they are logged in). We have a bunch of examples at this link .

  • Text Variables.

Text variables are $labels in the admin layouts which automatically generate text for the end user. E.g., “Welcome to $sitename”. More on text variables here .

Filter by label (Content by label)
showLabelsfalse
max5
spacescom.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@2655a4
showSpacefalse
sortmodified
typepage
reversetrue
labelskb-how-to-article training-material
cqllabel in ( "kb-how-to-article" , "training-material" ) and type = "page" and space = "RFCS"