Welcome!

CMS Authors: Mehdi Daoudi, Rishi Bhargava, Harry Trott, Xenia von Wedel, Carmen Gonzalez

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
The deluge of IoT sensor data collected from connected devices and the powerful AI required to make that data actionable are giving rise to a hybrid ecosystem in which cloud, on-prem and edge processes become interweaved. Attendees will learn how emerging composable infrastructure solutions deliver the adaptive architecture needed to manage this new data reality. Machine learning algorithms can better anticipate data storms and automate resources to support surges, including fully scalable GPU-c...
Machine learning has taken residence at our cities' cores and now we can finally have "smart cities." Cities are a collection of buildings made to provide the structure and safety necessary for people to function, create and survive. Buildings are a pool of ever-changing performance data from large automated systems such as heating and cooling to the people that live and work within them. Through machine learning, buildings can optimize performance, reduce costs, and improve occupant comfort by ...
The explosion of new web/cloud/IoT-based applications and the data they generate are transforming our world right before our eyes. In this rush to adopt these new technologies, organizations are often ignoring fundamental questions concerning who owns the data and failing to ask for permission to conduct invasive surveillance of their customers. Organizations that are not transparent about how their systems gather data telemetry without offering shared data ownership risk product rejection, regu...
René Bostic is the Technical VP of the IBM Cloud Unit in North America. Enjoying her career with IBM during the modern millennial technological era, she is an expert in cloud computing, DevOps and emerging cloud technologies such as Blockchain. Her strengths and core competencies include a proven record of accomplishments in consensus building at all levels to assess, plan, and implement enterprise and cloud computing solutions. René is a member of the Society of Women Engineers (SWE) and a m...
Poor data quality and analytics drive down business value. In fact, Gartner estimated that the average financial impact of poor data quality on organizations is $9.7 million per year. But bad data is much more than a cost center. By eroding trust in information, analytics and the business decisions based on these, it is a serious impediment to digital transformation.
Digital Transformation: Preparing Cloud & IoT Security for the Age of Artificial Intelligence. As automation and artificial intelligence (AI) power solution development and delivery, many businesses need to build backend cloud capabilities. Well-poised organizations, marketing smart devices with AI and BlockChain capabilities prepare to refine compliance and regulatory capabilities in 2018. Volumes of health, financial, technical and privacy data, along with tightening compliance requirements by...
Predicting the future has never been more challenging - not because of the lack of data but because of the flood of ungoverned and risk laden information. Microsoft states that 2.5 exabytes of data are created every day. Expectations and reliance on data are being pushed to the limits, as demands around hybrid options continue to grow.
Digital Transformation and Disruption, Amazon Style - What You Can Learn. Chris Kocher is a co-founder of Grey Heron, a management and strategic marketing consulting firm. He has 25+ years in both strategic and hands-on operating experience helping executives and investors build revenues and shareholder value. He has consulted with over 130 companies on innovating with new business models, product strategies and monetization. Chris has held management positions at HP and Symantec in addition to ...
Enterprises have taken advantage of IoT to achieve important revenue and cost advantages. What is less apparent is how incumbent enterprises operating at scale have, following success with IoT, built analytic, operations management and software development capabilities - ranging from autonomous vehicles to manageable robotics installations. They have embraced these capabilities as if they were Silicon Valley startups.
As IoT continues to increase momentum, so does the associated risk. Secure Device Lifecycle Management (DLM) is ranked as one of the most important technology areas of IoT. Driving this trend is the realization that secure support for IoT devices provides companies the ability to deliver high-quality, reliable, secure offerings faster, create new revenue streams, and reduce support costs, all while building a competitive advantage in their markets. In this session, we will use customer use cases...