Industrial IoT Authors: Elizabeth White, Stackify Blog, Yeshim Deniz, SmartBear Blog, Liz McMillan

Related Topics: Industrial IoT

Industrial IoT: Article

Letters To The Editor

Letters To The Editor

Online Learning
I just want to say thanks for the kind words in the article on carriglearning's online course offerings ["Gleaning Useful Lessons," Vol. 2, issue 8]. I didn't realize at the time that you were reviewing the course for publication!

David Gassner
[email protected]

A Content Management Solution
I'm working on a project that requires a content management solution. I read Jim Gabriel's articles ["Content Management," Parts 1 and 2, Vol. 2, issues 6 and 7] and found them very interesting. We're about to start Phase 3 (the Information Mapping phase). I wanted to know if you could direct me to additional, in-depth information on Information Mapping? Thank you in advance.

Reggie Farmer
[email protected]

I'm glad to hear that you found my article interesting. It represents a summary of one of the most demanding (and rewarding) jobs that I have ever undertaken! (At least, before becoming a CEO of my own software company....)

I assume that you're keen to design a set of document type definitions that semantically describe your business, as opposed to using a published standard such as Docbook. If you're adopting an existing standard, information mapping isn't really an issue. After all, the straitjacket exists already, all you have to do is make your content fit the jacket.

If you're keen to build something that matches your business closely (and I encourage you to take this step), I recommend you read about the trademarked information mapping technique at www.infomap.com/method/. This is certainly a good starting point for a general discussion of how to map your readers' requirements into document structures. However, bear in mind that most of this is simply good old common sense - thinking about the objects that you're writing about (reference information, illustrations, concepts, etc.) and the relationships that your readers will expect to see when using the information.

For example, in a piece of reference information, any mention of a concept that's crucially important to the readers' understanding of the material should probably be available as a concept topic that the reference information is linked to. This is a relationship that you need to chart, because it means that your authoring and publishing must make that relationship happen in the content. Typically, in a highly modularized system, you'll have a DTD for reference topics, a DTD for concept topics, and links between the two must be supported.

There are two very important aspects to the information mapping exercise:

  1. Information mapping will give you a starting point only.
  2. Any DTDs that you derive from the information map will also be a starting point only.
Building your own system means you'll be making a lot of changes. This requires revisions to DTDs and the consequent breaking of much data. Typically, a reused object in your information map may find its way into dozens of different places - and this is what makes change expensive. There's no way to support team development of DTDs and publishing systems or to analyze the impact of change - no backups, no source control, no way of versioning, no branching, no way of maintaining multiple schema versions (or objects in schemas) side by side, no way of autogenerating all associated property files such as the stylesheets and publishing scripts, no way of intelligently and automatically cranking existing document instances back in line with the new version of reality, and so on. There's a very long list of things that don't work at all when you need to change definitions, and the cost of these typically all fall outside the budget in a content management system project. I burned my fingers "bad" on that!

Without a magic solution, the bottom line is this: get somebody to help you who has done this before and be prepared to pay for him or her. If you don't, you need to put as much space in your first year's budget for maintenance as you do for building the system in the first place.

Good luck!

Jim Gabriel
[email protected]

I read your article on the potential of content management systems. Great story and we couldn't agree more.

FYI: for two years now we have a great content publishing framework that's currently in use by some major banks in Europe, also a joint venture with OCE (copiers, etc.) has been founded. The customers are impressed by the product.

Rolf Huijbrechts
[email protected]

More Stories By Ajit Sagar

Ajit Sagar is Associate VP, Digital Transformation Practice at Infosys Limited. A seasoned IT executive with 20+ years experience across various facts of the industry including consulting, business development, architecture and design he is architecture consulting and delivery lead for Infosys's Digital Transformation practice. He was also the Founding Editor of XML Journal and Chief Editor of Java Developer's Journal.

Comments (0)

Share your thoughts on this story.

Add your comment
You must be signed in to add a comment. Sign-in | Register

In accordance with our Comment Policy, we encourage comments that are on topic, relevant and to-the-point. We will remove comments that include profanity, personal attacks, racial slurs, threats of violence, or other inappropriate material that violates our Terms and Conditions, and will block users who make repeated violations. We ask all readers to expect diversity of opinion and to treat one another with dignity and respect.

IoT & Smart Cities Stories
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...
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.
@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...
When talking IoT we often focus on the devices, the sensors, the hardware itself. The new smart appliances, the new smart or self-driving cars (which are amalgamations of many ‘things'). When we are looking at the world of IoT, we should take a step back, look at the big picture. What value are these devices providing. IoT is not about the devices, its about the data consumed and generated. The devices are tools, mechanisms, conduits. This paper discusses the considerations when dealing with the...
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...
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.
The best way to leverage your Cloud Expo presence as a sponsor and exhibitor is to plan your news announcements around our events. The press covering Cloud Expo and @ThingsExpo will have access to these releases and will amplify your news announcements. More than two dozen Cloud companies either set deals at our shows or have announced their mergers and acquisitions at Cloud Expo. Product announcements during our show provide your company with the most reach through our targeted audiences.
Andrew Keys is Co-Founder of ConsenSys Enterprise. He comes to ConsenSys Enterprise with capital markets, technology and entrepreneurial experience. Previously, he worked for UBS investment bank in equities analysis. Later, he was responsible for the creation and distribution of life settlement products to hedge funds and investment banks. After, he co-founded a revenue cycle management company where he learned about Bitcoin and eventually Ethereal. Andrew's role at ConsenSys Enterprise is a mul...
Disruption, Innovation, Artificial Intelligence and Machine Learning, Leadership and Management hear these words all day every day... lofty goals but how do we make it real? Add to that, that simply put, people don't like change. But what if we could implement and utilize these enterprise tools in a fast and "Non-Disruptive" way, enabling us to glean insights about our business, identify and reduce exposure, risk and liability, and secure business continuity?