As a transitional step, this site will temporarily be made Read-Only from July 8th until the new community launch. During this time, you can still search and read articles and discussions.

While the community is read-only, if you have questions or issues requiring TIBCO review/response, please access the new TIBCO Community and select "Ask A Question."

You will need to register or log in or register to engage in the new community.

TIBCO Community Blog - Blog Writing Tips & Guidance

Last updated:
6:41am Jan 14, 2021

 

The purpose of this page is to share tips & guidance on how to write a TIBCO Community Blog

What is the TIBCO Community Blog?

The TIBCO Community Blog was created as a way to share your great stories with the TIBCO community whether it be on data science, analytics, integration, cloud technologies or any other related topic. We want this blog to become a wealth of topics that can inspire and enthuse readers to discover new and improved ways the TIBCO suite of products can be applied to their businesses and work. The ultimate aim of the blog is to become the go to place for the TIBCO community to find out all the exciting work we all do each day with TIBCO products. 

Who can publish a TIBCO Community Blog and who is the audience?

  • The audience for these blogs are all users of TIBCO Software no matter the product or the field. A blog should be inclusive and interesting to TIBCO customers.
  • TIBCO Tech teams - request blogger access via the TIBCO Community manager Don Johnson donjohns@tibco.com
  • Anyone ready to publish a blog - please request a peer review so that we can help establish a consistent quality and look and feel for our community blogs and also publish with a regular cadence where possible. You can ask the Product Maketing Management folks for your product, or Colin Gray cgray@tibco.com and Heleen Snelting hsneltin@tibco.com , have been gracious enough to volunteer to help you with this. 
  • In future we will consider partners to contribute blogs as well, our first customer already published one - stay tuned! And note that anyone can already publish wiki pages today.

What is the difference between TIBCO Community blog and TIBCO Community Wiki page?

Blogs are great ways to share your own story on work you have done, an idea you may have pursued, a challenge you faced. They are designed to be a more approachable and personal account of your chosen story or topic.

  • Blog: a personal account of something you learned or an exciting application of a technique which you think is worthwhile to share. A blog will expire. Written by one author.
  • Community wiki page: technical reference pages with step by step details on capabilities, use-cases, events - good wiki pages are maintained and are current. Content often contributed by mutliple authors.

Ask yourself: Am I trying to tell a story and share my experience, or am I trying to teach someone how to do something. The former is better as a blog, the latter a wiki article.

What is the length, format and style to use?

  • A blog should be written from your own point of view and experiences. So aim to write in a friendly, and accessible manner as if you were speaking to your reader 1:1. Think about the challenges you faced, knowledge you gathered, the way any problem was solved. If it was interesting and/or useful to you, it will be useful to others! 
  • Bear in mind the audience - a blog should be understandable to a general audience, so avoid excessive use of technical terms or heavily technical content (these are more suited to the TIBCO Community Wiki)
  • Be honest - a blog should be about the journey you took and the experience gained, not about the perfect scenario that is far from reality.
  • Use a succinct title that will grab readers attention and give them a clear indication as to what your blog covers.
  • Aim for fewer words around 750 to 1,000 - use a punchy writing style and avoid excessive use of difficult or complex language. English language only.
  • Include screenshots and images to help enhance your story and put your thoughts into context. Never link to images on a Gdrive or copy and paste them into your blog, always upload them using the Media Explorer (see icon second from the right when editing a page).
  • Add an image to the top of your blog before any text. This means on the blog homepage the image will show which is more eye catching than text. The optimum image dimensions for this blog thumbnail are: 650px by 366px or 800px by 254px. To do this click at the top of your blog, change the style to be Heading 3 and then add you image using the media browser. Do not edit the dimensions in the media browser, you must edit the image before uplading itself.
  • Add a picture and bio about yourself to the bottom of the blog. Blogs are personal and readers like to get to know who the author is. The ideal way to do this is to create a table with two columns. Once on your page, right click on the cell on the left and set its wide to 200px. You can then add a thumbnail photo of yourself into this cell (using the media browser for example), and add your bio text to the cell on the right.
  • Consider writing a complimentary wiki article to your blog. Readers often want the detail on how to implement what they learn about in your blog, so a wiki is an ideal way to do this and helps drive traffic to your blog.
  • Add links to your blog to other relevant wiki, blog or related articles on TIBCO's (or beyond) site. Cross linking helps people find useful releated content and also with search engine optimisation.
  • Be careful to ensure no sensitive, or personal data or information is contained in any screenshots, or in the text of your blog.
  • Add (hash)tags to your blog using the add/edit tags option at the top of the page once published.

More notes for the authoring process

  • Review links in the "how to use the TIBCO Community" section on this page with detailed info as a next step where appropriate
  • Product names listed should follow TIBCO marketing guidelines - community manager will update if needed
  • Use tags to help readers use the filters on the main blog page to find blogs of interest
  • Data or code examples shared in the blog should be public - when in doubt please check with TIBCO Community manager Don Johnson donjohns@tibco.com
  • There are many excellent guides online on how to write a blog. Take some time to review these if required such as this WordStream guide or Writers Digest guide.