pdf

Clearspace Quick Tour

Welcome to the Clearspace Tour! Use this tour to get a step-by-step view of some of the things you can do with Clearspace. As you read through the tour, it will point out features and suggest things you can do to start putting Clearspace to work for you and your team. Here are the steps:

Get Started

Find Content

Get It Your Way

Create Content

Collaborate on Content

Get Things Done

For other introductions to Clearspace, be sure to see the Jive Software web site. There, you'll find illustrations that show Clearspace in action, as well as a feature-by-feature description. You might also be interested in looking through the Clearspace Help, which answers common questions about how to get things done in Clearspace.

Get Started

Get to know Clearspace. When you first log into Clearspace, the home page offers links to places where you can dive in. By default the changed items are listed with the most recent first. Use the document type icons, titles, and change age ("3 hours ago") to decide if there's anything of interest for you here at the top level.

Homepage

The content type icons are your first clues as to the kinds of content you'll find and create in Clearspace: wiki documents, blogs, and discussions. You'll learn more about the types later in this tour. From the home page you can also get a feel for how you can find content. For example, through the sections on the home page you can browse by space, browse by content types or browse by tags (more about tags later, too).

Also, notice that menu bar near the top of the page. It's available on all the other pages, too. Use it to:

After you've gotten to know what's inside pretty well, use the Your View link at the top of the What's New box to choose which content you want to appear here.

In the Find Content section of the tour you'll learn how to stay on top by using spaces, searches, tags, notifications, and something called "feeds.

Find Content

As you saw on the Clearspace home page, you've got a number of paths into the content. You can browse by space, by content type and tags, and you can search. (You can even browse for content by other people — just try clicking someone's name.) This section of the tour will introduce you to Clearspace's content-finding features.

Browse spaces. Most content in Clearspace is organized by spaces (some blogs aren't connected to a particular space). In spaces, you create, find, and organize content.

  1. On the home page, click the Browse menu. Notice that spaces are organized in a hierarchical list.

    Browse menu

  2. Click the name of a space. If the space's home page overview has been customized, you're likely to see an arrangement of content that's tailor made for you as a visitor to the space. You'll also find lists of the latest content of each other content type: discussions, documents and blogs (if the space features blogs). Use the All Content, Discussions, Documents, and Blog Posts tabs to get more of each kind of content.

    Content list

If you haven't already, take a moment to browse your spaces.


Browse by tags. When you browse by tags, you're using a community-made indexing system. You and other people apply tags like index keywords to new content to make the content more findable. You look for content you want by clicking tag names to see a list of related content. Wherever you go in Clearspace, you'll see tags that group your content into categories.

  1. Look for the tag cloud. If your team has had a chance to add and tag content, the home page for a space also shows something you'll probably find yourself using quite a lot: a tag cloud. A tag cloud visually groups tags so that you can look by popularity (more popular tags are in a larger font) as well as look by alphabetical order.

    Tag cloud
  2. See the content associated with a tag. Hover over a tag to see the number of times it is assigned to content. Click the tag to see a list of the items it's assigned to.

    Recruiting tag

Search for content. Search for the content you want, filtering your search to refine the results.

  1. Take a look at the Search box in the upper right corner.
  2. Type in what you want to search for, then click Search.

    Search box
  3. See results on the Search page. You can filter search results by content type, by space, or by date. You might also see search results from outside of Clearspace listed under More Results. You'll get these if your system administrator has connected OpenSearch sites to Clearspace.

    Search results

Through browsing and searching Clearspace you can look for the content you need. But what if you've found something you want to keep your eye on? By subscribing to RSS feeds or email notifications, you can get updated on changes to content you care about.

See the next part of the tour for an introduction to RSS and email notifications.


Subscribe to RSS feeds. Ever want a way to see what's new or changed on your favorite web sites without having to visit the sites? You can use Real Simple Syndication (RSS) to get a digest of updates to the stuff you're interested in. When you "subscribe" to an RSS feed — say, for particular search results or a tag or the content of a space — your RSS reader (which might simply be your web browser) does the checking for you. With RSS, you can subscribe to nearly anything in Clearspace!

If RSS sounds appealing, take a moment to get it set up. Select one of the Clearspace RSS feeds and subscribe. If you select a reader to use for all feeds, subscribing is as easy as clicking the RSS icon where you see it in Clearspace.

Note: When subscribing to Clearspace feeds, you might need to associate your Clearspace user name and password with the subscription.


Get notified by email. In addition to RSS feeds, you can also stay on top of content using email notifications. When you sign up to receive email notifications, Clearspace will send you email whenever the content you're interested in changes.

Get It Your Way

You'll want to personalize your home page. Maybe not today, maybe not tomorrow, but soon and for the rest of the time you're using Clearspace.

As you and others use Clearspace, the amount of content there will grow. You'll develop a preference for certain people's blogs, for discussions in certain areas, and you'll learn that some areas just rarely have anything you need.

  1. Go the home page and click the Your View tab to begin designing your personalized view.

    Your View tab

  2. Click the personalize link to jump into design mode.

    Personalize link

    Notice how the page in design mode is divided into a top part and larger bottom part. In the box near the top of the page is a list of widgets. Most widgets are special views on content or people in Clearspace; a few provide other ways to add other things, such as notes and links to stuff on the web.

    Beneath the list of widgets is a design already started for you. This design is an arrangement of widgets for you to change by rearranging it, removing widgets, and adding some you'd rather have.

  3. Notice the widgets you don't want and remove them by clicking their Remove button.

    Remove widget
  4. Hover over the list of widgets at the top of the page and notice that each has a description next to the Cancel and Save buttons.

    Hover widget
  5. Next, grab the widgets you want, drag them onto your design...

    Grab a widget
  6. ...then drop them where you want them.

    Drop widget
  7. Click the widget's Edit link to edit its properties. This is where you fine tune the widget so that it shows you what you want.

    Edit user widget properties
  8. Click Save Properties to save your changes.

    Saved user widget
  9. When you've got the widgets you want in the design, click Choose a layout for ways to set up the columns on the page. Notice that the top of the page now displays possible layout arrangments you can use. Click each one to see how your personalized page looks. As you consider layouts, you can drag your widgets from column to column by grabbing the widget's name.

    Choose layout

  10. Once you've got your design where you want it, click Save. As you use Clearspace, remember that you can come back to design mode by clicking the Personalize link.
  11. In the Create Content section of the tour you'll learn more about the kinds of content you can create in Clearspace.

Create Content

You'll find the content you need with Clearspace. But if you use it long enough, there's a pretty good chance that you're going to want to make your own contributions. And that where things really get interesting. As you join others in the space — getting answers to your questions, finding documents you need day to day, reading others' thoughts in a blog — you'll discover ideas you wouldn't otherwise have seen. And you'll want to get them out of your head and into Clearspace.

Ask a question, get some quick feedback. Discussions are great for those brief questions and comments. It might start with a simple question.

  1. Click New > Discussion to start asking a question or make a quick post to find out what others think.

    New discussion

  2. Mark your post if it's a question. You can simply post a comment for feedback from others. But if you're asking a question, be sure to mark your post so that others know you'd like an answer.

    Post question

  3. Tell others which responses got you where you wanted to go. When someone responds to your question with a post that's helpful or correct, mark it as such so that others know which is the best answer. You and other people get status points for helpful and correct answers.

    Helpful answer

Create a document to preserve team thoughts. Wiki documents and uploaded files give you a way to get content into Clearspace. With wiki documents, you edit the content right in Clearspace. You and others can work on the same document and it's searchable. As you'll see later, you can also specify that other people should review or approve the content. By uploading a file, on the other hand, you can add something that was created outside Clearspace. Uploading the file makes it available to other people; you can tag the uploaded file to make sure it gets found.

A wiki document is for capturing information that others on the team would be interested in (or might just need) — things like agendas, plans, meeting notes, equipment lists, and the like. They're team documents.

  1. Click New > Document to start a new document.

    New document

  2. Start a new wiki document. Anyone will be able to edit this document. (Later in this tour, you'll learn how to limiting a document's visibility.)

    Choose document type

  3. Give the document a title and type your content in the editing window. Notice that you've got two ways to edit the document, along with a preview pane to see how your work is coming along. The rich text editor is like a word processing program, with tools for more advanced formatting.

    Document editing

    The plain text editor (shown below) offers simple formatting features, but is designed primarily for editing in the wiki markup style. Click the help link at the right side to see a list of wiki markup conventions you can use.

    Plain text editor

  4. Add tags to describe the document to other people. This is one of best things you can do for your team. As you and other people add tags, you'll develop your own expressions to describe the content you all use. For those expressions to be most useful, try to use existing tags whenever possible.

    You can type the tag names, letting Clearspace finish the name where the tag already exists; you can also click the tag in the Popular Tags list to add the tag to the document.

    Add tags

  5. You can click Save and Continue to save your work and keep writing or click Save Draft to finish later. Click Publish when you're ready for others to see your document.
  6. After you've published the document, notice that the Actions list lists tasks related to the document. In particular, notice the Manage versions and Manage collaboration links. Click Manage versions to display a page that lists versions of the document. You can select document versions in the list to compare changes to the document over time. The comparison shows additions and deletions.

    Version comparison

 Tip: You can make a document from a discussion! View the discussion in Clearspace, then click the Convert thread to document link under Actions.


Post your views to your blog. While wiki documents are often authored by the team, blogs are for more individual kinds of content. A blog might be the voice of a department (such as human resources) or of an individual (such as you). A blog is a like a column in a newspaper — it's there when you look for it, now and then offering something new to read. Unlike a newspaper column, though, others can comment on a blog.

If you've got a blog, you might post your views on something you just read that others in the organization might be interested in. Or you could evaluate or summarize something for the team, providing a way for others to give feedback through their comments on your blog.

  1. Click New > Blog Post to post to your blog.

    New blog post

  2. If you're prompted, select the space in which you want your blog to appear.
  3. Notice that the blog editing page is very much like the discussion and document editing pages: the same rich text and plain text editors are available, along with a preview tab. Notice, too, that you get a number of shortcuts to tools that are specific to blogs. You can view the posts you've made,  comments to your posts, trackbacks (links to other sites that have linked to your blog), and blog options such as moderation and RSS feed settings. The Extended Options section expands when you click its title. There, you can set options specific to this post — even set it to be published at a certain time.
  4. In the editing window, type a title and the content of your blog post.

    Rich text editing for blogs

  5. You can Save a draft of the post before you publish. As with discussions and documents, be sure to add tags before you click Publish; tags will help your post be easier for others to find.

Create a profile. Your profile is a quick way for other members of your team to find out more about you. It can be bare bones or more thorough. If you fill in the optional fields, you can give others a sense of who you are and what you know. It can be very useful in a team to know who to go to when you've got a question or suggestion in mind.

  1. Click Your Stuff > Profile to view your profile.

    Edit profile

  2. On your profile page, notice that the Actions list lists a few things you can do. On the preferences page you can adjust your notification and subscription settings.
  3. Click Edit Profile.
  4. Fill in as much profile information as makes sense. Keep in mind that your profile will be found when people search, so if you have professional roles or interests that would be useful for others to know, be sure to include them.

    Edit profile

Collaborate on Content

Nearly everything you do in Clearspace is about collaboration. Content you add is almost always visible and searchable by everyone (unless you've explicitly indicated that its visibility should be limited to certain people). Other people read your work, you read theirs. You get ideas from someone else's blog, they comment with suggestions on your document.

But Clearspace provides ways through which you can manage collaboration. For example, you can say that only certain people are collaborating on a document with you. You can say that some of these people can edit the document, while others must approve it before it's visible to everyone.

Note: Publishing a document always makes it visible to everyone who can ready documents (which is typically everyone using Clearspace). If you want to limit a document's visibility, save it as a draft!

Add collaborators. When you first create a wiki document, you limit its visibility by setting its collaboration options. When you add people to edit and approve a document, you're giving them special roles in what's called the document's "workflow." In other words, work on the document starts in one place — a draft — and moves through a process — possibly more drafts, review, and approval — until it's ready for publishing.

  1. Click New > Document to create a new document.
  2. Scroll to the bottom of the page and click Collaboration Options.
  3. In the Specific Users box, enter the Clearspace user names of the users you want to be able to see and edit the document. (You can also click the Just <my_name> option if you want to be the only person who can see and edit.)

    Collaboration options
  4. If you want certain people to be required to approve the document before it's published and visible to others, enter their user name in the box under Users who must approve...
  5. Under Comment Policy, choose how you want comments to the document handled.
  6. When you're done editing the document, be sure to click Save Draft rather than Publish. (Clicking Publish will make the document visible to everyone!)

After you've saved the document, you can come back later to edit these options by clicking the Manage Collaboration link in the Actions list. The people you added to edit and approve the document will be able to get to this document from their Your Stuff menu and from the Your Stuff tab of their own profile.

Profile approval

The document itself will also let approvers know that it's time to approve.

Approve or reject

Get Things Done

You've got people sharing ideas and contributing content. When specific schedules and goals drive their work, create a project to focus it. In Clearspace a project is a way to collect tasks and schedules with other kinds of content to collaborate toward an overarching goal.

  1. Go to the space where the project should live.
  2. In the Actions list, click Create a project.

    Create a project
  3. Enter information to get your project started: what it's called, what it's for, and a target completion date. Create a project blog to make share information — status, research, other thoughts — that people working on the project can use.

    New project details

    After you've created the project, you'll see the home page. Here, you can get started creating the tasks and checkpoints that make up the substance that sets a project apart. You can customize this page just as you can with your personalized home page or a space overview page.

    Project home page

    You'll use checkpoints to map out your project's milestones, with tasks between the checkpoints.

  4. To add a checkpoint, in the Actions list click Create a checkpoint, then enter the details.

    Create checkpoint

    As you add checkpoints, notice that they're visible on the Overview page in the Checkpoints list and the Project Calendar. Hover over a checkpoint in either place to edit or delete it.

    Checkpoints on calendar

    Start adding specific, smaller-grained tasks that can be assigned to someone for completion between checkpoints.

  5. To add a task, in the Action list click Create a task. Use the Add Task page to enter the task details. Assign the task to someone and give it a completion date. You can edit it later.

    Tasks on the calendar
  6. Click the Tasks tab or a task title link (in the Tasks list, for example) to view a list of tasks to do for the project. In the To do list, you can filter the tasks by assignee and completion.

    Tasks to do
  7. You can also create personal tasks for yourself that aren't associated with a project at all. These will also appear in your task list. Click New > Task to start creating a personal task.

    Create a person task
  8. If you personalize your home page, you can also keep track of your tasks there using the Your Tasks widget.

    Your Tasks widget

This is the end of the Clearspace tour, but it has really only scratched the surface. The best way to get to know Clearspace is to put it to work by adding content and responding to the content other people have added. Give it a try!