Wikis - the What, How and Why
Last updated:
4:00pm Apr 30, 2018

Welcome to the TIBCO Community Wiki!

HNL Wiki-Wiki Bus

Wiki is Hawaiian for 'Quick'. The 'wiki-wiki' bus was a Honolulu airport shuttle bus that seemed to be everywhere and was the quickest way to get anywhere. *

In our context, a Wiki is a system for quickly creating content. In general, any authenticated user should be able to create or edit a Wiki page.

Subject Matter Content is King

When creating a Wiki page, concentrate on the subject matter content that you want to add. Leave most styling (fonts, text size) issues to the CSS for the website. This way, as we evolve the website, your pages will evolve alongside the rest of the site. Your job is to create the content as clearly and concisely as possible.

For example, if you don't know all the ins and outs of ordered and unordered lists, don't struggle to create them. Type them in as best you can manually, but make sure that process list steps are clear and correct.

Here's an Example of a well produced Wiki page:  Spotfire Visual Design Best Practice

You Have an Editor

I mean a human editor, me.  I will review each wiki page created or updated and very well may copy-edit the page myself.  If you referred to another part of TIBCO's websites, I might add a link in to that site.  I might adjust image sizes or fix spelling errors and other things that an English Teacher might do. I will try and preserve your voice, but I will make sure that your page preserves the look and feel of the website as a whole.

One of the most important design concepts that many folks might not be attuned to yet is the concept of 'Responsive Web Design'.  Pages display differently on small viewports (smartphones and tablets).  Trying to force formatting by stipulating height and width attributes for images, tables, etc, usually break when viewed on a smartphone.  Also for website look and feel, fonts, fontsizes, font/background colors, and header attributes should be left to the site's CSS.

You Have an Editor

I mean a WYSIWYG Editor.  It can be powerfully helpful, or maddingly frustrating, depending on what you're trying to do and what your level of expertise is.

You Have an Audience

The TIBCO Community website will have a mix of types of folks engaging with it.   They will not all be paying, existing customers.  So don't assume that they have access to support sites that are restricted to paying customers. This also means that you are not to include customer information in Wiki articles, since those pages will be open to anyone on the World Wide Web.

Member Journeys

Understanding your audience is critical to creating content that meets the needs of the community. Taking a concept from Marketing, the 'buyers journey', we can identify certain journeys that our community members are likely to be taking.

Evaluators Journey

This is a member who has signed up in order to evaluate one or more of our products.  It may be that registering is a requirement to download either trial versions of products or the Documentation associated with our products.

New User Journey

This is a member who has been given the task to get a TIBCO product going and integrated into a company's technology infrastructure and/or its business process.  These are the 'Getting Started' folks.

Troubleshooter Journey

This is the member who is trying to fix something they think is broken. They may have a support ticket open, they may not. But they are in the site to try and understand what to do next.

Community - The "How-to" of the TIBCO Web Ecosystem

Our community sites are for answering the "How" of our products and services.  Our commercial sites, such as tibco.com, are for answering the "What, Who and Why" of our products and services. While this is not always a clear call on a particular piece of content, it is usually is.  Pure marketing communications are for commercial sites and is 'Out of Scope' for our community site.

This is true for us as TIBCO staff. It's also true for TIBCO Partners, official or unofficial.  Partners, large or small, can have a presence here as long as its done thru this "How-To" principle.

You Will Have Questions

Don't hesitate to ask,  eMail me, Don Johnson