Welcome!

Agile Computing Authors: Elizabeth White, Pat Romanski, Liz McMillan, Yeshim Deniz, Andy Thurai

Related Topics: Agile Computing, CRM, CMS

Agile Computing: Blog Feed Post

Create a User Guide With WordPress & Jing for Free

With WordPress.com I didn’t need technical help from my overloaded developer team

As my development team at MioWorks rounds the corner on a significant update, I thought it was important to have a user guide that explained the features and told the story of the MioWorks application.  I started looking into online help systems around the open source ecosystem.  It seemed that everything I found was either overly complex or required time from my development & system administration team.

As my frustration level grew I realized that WordPress was a solution I could use.   With WordPress.com I didn’t need technical help from my overloaded developer team.  I didn’t need any training since I already know the application from blogging.  And of course, the price is just right for a start-up company.

You may only think of wordpress.com as a blogging site.  But what you may not know is that you can create content pages in a hierarchy.    I decided to use content pages organized into chapters to mimic a user guide.  I started out by defining the top 5 “sections” of my guide.  I then added subsections to each of those to provide details on different features.  I quickly “stubbed” out the entire site and started to view it in different templates to see how it looked.  I found that using the “Freshly” theme with a custom header made for a nice looking user guide that closely resembled the color scheme of my application – a double bonus!  I applied the theme, uploaded my header and I was happy with the result.

The next step was to assign a domain name to the wordpress.com site.  I choose http://userguide.mioworks.com as the new URL for my wordpress site.  I followed the instructions provided by wordpress, adjusted a CNAME on my DNS records and then paid $9.97 for a year of domain forwarding to WordPress.com.   The site was live and accessible from the URL.

Now it was time to start adding content.  I wanted to not only provide text descriptions but I also wanted to have accurate screen shots that were legible with call outs and numbering when needed.  The perfect tool for this task is  Jing by Techsmith. Jing runs on both Windows and Mac OS.  Jing not only allows you to capture a screen shot, it allows you to quickly annotate that screen shot and save it as a PNG file.   The process to capture a screen, annotate it, save it locally and then upload it to wordpress.com was very simple and fast.

The process of documenting the entire application took a few days but the end result is well worth the effort.  MIoWorks now has a complete user guide that will help existing clients take advantage of all the features inside the application.  It will help guide them on not only the purpose of a feature but includes examples of how those features can be used.  I really like the user guide because it will also serve as a learning tool for potential clients that want to see more before they decide to use our application.

Read the original blog entry...

More Stories By David Abramowski

David Abramowski is a technologist turned product leader. David was a co-founder of Morph Labs, one of the first Platform as a Service plays on AWS. He was the GM for Parallels Virtuozzo containers, enterprise business, and most recently he is the leader of the product marketing team for the IT Operations Management solutions at the hyper growth SaaS company, ServiceNow.

IoT & Smart Cities Stories
SYS-CON Events announced today that DatacenterDynamics has been named “Media Sponsor” of SYS-CON's 18th International Cloud Expo, which will take place on June 7–9, 2016, at the Javits Center in New York City, NY. DatacenterDynamics is a brand of DCD Group, a global B2B media and publishing company that develops products to help senior professionals in the world's most ICT dependent organizations make risk-based infrastructure and capacity decisions.
CloudEXPO New York 2018, colocated with DXWorldEXPO New York 2018 will be held November 11-13, 2018, in New York City and will bring together Cloud Computing, FinTech and Blockchain, Digital Transformation, Big Data, Internet of Things, DevOps, AI, Machine Learning and WebRTC to one location.
@DevOpsSummit at Cloud Expo, taking place November 12-13 in New York City, NY, is co-located with 22nd international CloudEXPO | first international DXWorldEXPO and will feature technical sessions from a rock star conference faculty and the leading industry players in the world. The widespread success of cloud computing is driving the DevOps revolution in enterprise IT. Now as never before, development teams must communicate and collaborate in a dynamic, 24/7/365 environment. There is no time t...
DXWordEXPO New York 2018, colocated with CloudEXPO New York 2018 will be held November 11-13, 2018, in New York City and will bring together Cloud Computing, FinTech and Blockchain, Digital Transformation, Big Data, Internet of Things, DevOps, AI, Machine Learning and WebRTC to one location.
Cloud-enabled transformation has evolved from cost saving measure to business innovation strategy -- one that combines the cloud with cognitive capabilities to drive market disruption. Learn how you can achieve the insight and agility you need to gain a competitive advantage. Industry-acclaimed CTO and cloud expert, Shankar Kalyana presents. Only the most exceptional IBMers are appointed with the rare distinction of IBM Fellow, the highest technical honor in the company. Shankar has also receive...
A valuable conference experience generates new contacts, sales leads, potential strategic partners and potential investors; helps gather competitive intelligence and even provides inspiration for new products and services. Conference Guru works with conference organizers to pass great deals to great conferences, helping you discover new conferences and increase your return on investment.
Headquartered in Plainsboro, NJ, Synametrics Technologies has provided IT professionals and computer systems developers since 1997. Based on the success of their initial product offerings (WinSQL and DeltaCopy), the company continues to create and hone innovative products that help its customers get more from their computer applications, databases and infrastructure. To date, over one million users around the world have chosen Synametrics solutions to help power their accelerated business or per...
DXWorldEXPO LLC announced today that ICOHOLDER named "Media Sponsor" of Miami Blockchain Event by FinTechEXPO. ICOHOLDER gives detailed information and help the community to invest in the trusty projects. Miami Blockchain Event by FinTechEXPO has opened its Call for Papers. The two-day event will present 20 top Blockchain experts. All speaking inquiries which covers the following information can be submitted by email to [email protected] Miami Blockchain Event by FinTechEXPOalso offers sp...
SYS-CON Events announced today that IoT Global Network has been named “Media Sponsor” of SYS-CON's @ThingsExpo, which will take place on June 6–8, 2017, at the Javits Center in New York City, NY. The IoT Global Network is a platform where you can connect with industry experts and network across the IoT community to build the successful IoT business of the future.
IoT is rapidly becoming mainstream as more and more investments are made into the platforms and technology. As this movement continues to expand and gain momentum it creates a massive wall of noise that can be difficult to sift through. Unfortunately, this inevitably makes IoT less approachable for people to get started with and can hamper efforts to integrate this key technology into your own portfolio. There are so many connected products already in place today with many hundreds more on the h...