Is structure important?
Do you structure your content?
Do you have an information architecture (e.g., a taxonomy)?
Do you have a document architecture (e.g., content model)?
Structured writing requires an extensive analysis of content and a reorganization into the smallest possible coherent topics.
The reduction in structured authoring time may be offset by the increased time needed to analyze the content and break it into reusable chunks.
There is no doubt that granular content, with well-defined purposes for each paragraph and sentence, is easier to author than long-form narrative content. But you may need skilled (read more expensive) information developers to chunk your material.
What is Information Architecture anyway? The term is used by librarians to describe the organization of their document collections. It is also used by content managers to describe their content model or information model. This latter should probably be called Document Architecture.
The terms Information Architecture and Information Architect were first coined by Richard Saul Wurman, a real architect who created the theme for the 1976 convention of the American Institute of Architects. His theme was The Architecture of Information. Twenty years later, Wurman solidified the essence of his vision with the 1997 book Information Architects, which documented the work of twenty leading designers of illustrations, diagrams, publications, software, and exhibits.
His book began with a dictionary definition: Information Architect [L. info-tectus] n. 1) The individual who organizes the patterns inherent in data, making the complex clear. 2) a person who creates the structure or map of information which allows others to find their personal paths to knowledge.
A year later, Peter Morville and Louis Rosenfeld chose the term Information Architect to name a new discipline of organizing, labeling, navigating, and searching the information on the World Wide Web. They wrote the very influential O'Reilly book, Information Architecture for the World Wide Web (the 3rd edition is now shipping), and in 2002 founded the Information Architecture Institute.
They were giving substance to a third meaning proposed by Wurman: 3) the emerging 21st century professional occupation...focused upon...the science of the organization of information--Information Architecture.
The IAI founders included librarians (Peter is a Lecturer at the University of the Michigan School of Information) who wanted to make their training and experience in categorizing, cataloging, and browsing library collections of documents relevant to those building web sites. Marketing themselves as Information Architects greatly improved their job chances in cyberspace.
Now a website is clearly a collection of documents (web pages) that needs to be managed like a library. Librarians define their objectives in simple terms: help users to 1) navigate the library, 2) locate or find documents, 3) identify them uniquely, 4) select the right document, and 5) access the document physically or electronically (online).
But there are many other disciplines that think of themselves as organizing information, structuring it and mapping it to make it more usable and accessible. Long email exchanges on the IAI mailing list wrestle with what makes an IA different from many neighboring disciplines like Visual Designers, Interface Designers, Interaction Designers, Usability Professionals, and User Experience Engineers.
There is an additional major discipline, one of critical importance to content management, which has been doing another kind of information architecture for decades: what should be called Document Architecture. Document Architects are interested in the internal structure of documents. Indeed, most of the Wurman's Information Architects were structuring documents, even single illustrations, and not collections of documents.
Every writer has an approach to structuring writing, but today formally structured documents are a critical necessity as content has to be reused and repurposed to multiple publishing delivery channels. With the globalization of business and its content, the information may have to be translated into dozens of languages, retaining its structure so it can be delivered to many publishing platforms, which differ greatly from country to country. We think of the developing countries as backward in their ability to access web content, but the U.S. and Europe are distinctly backward compared to countries like Korea and Japan where 30 Mbps bandwidth is commonplace and as much commercially valuable content is delivered to advanced cell phones as to conventional desktops.
The discipline most involved in document structure is the Society of Technical Communicators who produce the documentation and user training manuals for the world's products and services. But the techniques of structured authoring, single sourcing, content reuse, controlled vocabularies, and simplified English are proving to have enormous returns on investment when applied to the fastest growing content in the world, electronic content, which also includes all the marketing content for the world's websites.
Pioneers of the field include Robert Horn of Information Mapping, who researched the best methods for analyzing, organizing, and arranging words and illustrations on a page to reveal the form, structure and relationships inherent in the information, John Carroll of IBM who promoted Minimalism (a technique for telling the user only that which they need at the moment and in the given context), and JoAnn Hackos, whose books on user and task analysis, managing documentation, and standards for online communication have identified best practices for single-source publishing.
Just as the exchange standard for information on the Web is now XML, so XML, especially the limited vocabulary of DITA information types, has become the standard for structured documents.
If your content is aready organized and structured with a content model, It does not mean that DITA is necessarily a good fit. You must compare your content model and the DITA content model. If yours is already XML, a transformation (ASLT) to DITA information types may be very easy.
Even if you keep your existing model, for XML elements that are served by an automatic publidhing system, you can simply add DITA XML for your new documentation and your XML architects should be able to integrate them alongside your existing content.
Up to Making the Business Case for DITA.
- Login to post comments
- 10430 reads
Structure is important!
I think you provide many good reasons why structure is important. The focus tends to be on creating authoring efficiences, however, and while this sells DITA as a business case, I think the IA has concerns beyond this. "Findability" and reducing cognitive load (for both authors and readers) are two important aspects that do not necessarily have immediate business impact, but vastly improve the use of the documents.