• 10 hours
  • Medium

Free online content available in this course.

course.header.alt.is_video

course.header.alt.is_certifying

Got it!

Last updated on 11/9/21

Create a Confluence Site and Your First Wiki Pages

Log in or subscribe for free to enjoy all this course has to offer!

Popular Wiki Products

There are several wiki products out there that are worth considering, such as:

  • Confluence - developed by Atlassian, this is by far the most popular wiki.

  • Notion - a wiki with great design and free to use (until you reach a certain number).

As I said, Confluence is the most popular wiki used in companies today, so we'll use it to store user stories and acceptance tests in the following chapters.

Set Up Confluence

There are a few steps to creating a wiki with Confluence:

1. Create an account on Confluence using this link.

2. Make sure to write down your password somewhere secure. You'll get an email with a link to confirm.

3. Start a Confluence trial using this using this link.

  • Click on the try it free button
    A screenshot of the Confluence sign-up

4. Choose a site name. It can be anything you like and will appear in your wiki URL (e.g., if your company were called Google, then you could use the name 'google' and the URL to your wiki would be http://google.atlassian.net).

  • Choose a site name (any name at all will do!) and fill out basic information like name email and password
    Choose a site name (any name at all will do!)

    5. Create a space called Product. Spaces are areas in Confluence (e.g., You would store the marketing documentation in the marketing space and the product documentation in the product space).

    name and create your space by clicking continue to store your work
    Create a space

    6. Create your first wiki page and hit save! 

Create Your First Wiki Page

Let's go back to an example from a previous chapter:

  1. We decided to look at a feature (called a quiz). 

  2. We went through a process to write 14 user stories for this quiz feature.

  3. We then wrote acceptance tests for some of these user stories.

Now, let's use a Confluence wiki to store this information so the team can access it:

  1. Create a wiki page for the quiz feature. 

  2. Create 14 user story pages.

  3. On the Quiz page, write down the user stories and add a link to each individual user story page.

  4. Add the acceptance tests (that belong to a given user story) on that user story's page. 

Create a Feature Page for the Quizzes

Let's begin by creating the following sections on the wiki page and then fill them:

  1. Background - Add a general text description of the feature.

    A background section adds some general context
    A background section adds some general context
  2. Screenshots - A picture can tell a thousand words, so put one or two screenshots (graphic designs) here.

    Screenshot of a quiz
    Add a screenshot to help the reader absorb the idea more quickly
  3. User stories - Create a table with one user story per row and a link to a full wiki page (which will eventually include the user story details) beside it. 

    The User Stories section is the most important because it links to each story's wiki page
    The user stories section is the most important -linking to each story's wiki page
  4. For corporate or product documentation, there are typically some existing related wiki pages that may be useful to link to here to provide more context.

A links section allows you to add references to related material
A links section allows you to add references to related material

Address a Few General Concepts

The following general wiki concepts were demonstrated in the screencast, but try them out for yourself:

  • Linking from any wiki page to any other.

  • Text formatting into Heading 1, Heading 2, paragraph, etc. (which helps you make nice heading sections).

  • Creating tables to present information (we put our user stories into a table).

  • Inserting images or documents (this is easily done, which means you can store all relevant documentation (including Microsoft PowerPoint slides, Microsoft Word/Excel documents, or PDF documents) all in one central place - your wiki!

Make sure you are comfortable with these concepts before moving on. If not, watch the screencast again!

Let’s Recap!

  • Wikis are a great tool to help the team achieve better transparency and understanding of their work.

  • Confluence and Notion are very popular wiki platforms in use by many organizations.

  • Wikis are a good way to help document your work.

Now that you have created your own wikis, you're ready to create the perfect user stories. So let’s get to it in the next chapter!

Additional Resources

  • Atlassian provides a platform where you can download free Jira software and service management tools to assist you. You can access it here.

  • Notion (a newer tool) repository allows you to blend your everyday work apps into one. It's the all-in-one workspace for project management. You can access it here.

  • Getting started with Confluence

Example of certificate of achievement
Example of certificate of achievement