Topic-based Authoring
   HOME
*





Topic-based Authoring
In technical communication, topic-based authoring is a modular approach to content creation where content is structured around topics that can be mixed and reused in different contexts. It is defined in contrast with ''book-oriented'' or ''narrative'' content, written in the linear structure of written books. Topic-based authoring is popular in the technical publications and documentation arenas, as it is especially suitable for technical documentation. Tools supporting this approach typically store content in XHTML or other XML formats and support content reuse, management, and the dynamic assembly of personalized information. A topic is a discrete piece of content that: * focuses on one subject * has an identifiable purpose * does not require external context to understand Topics can be written to be independent of one another and reused wherever needed. The Darwin Information Typing Architecture is a standard designed to help authors create topic-based structured content. The ...
[...More Info...]      
[...Related Items...]     OR:     [Wikipedia]   [Google]   [Baidu]  


Technical Communication
Technical communication is used to convey scientific, engineering, or other technical information. Individuals in a variety of contexts and with varied professional credentials engage in technical communication. Some individuals are designated as technical communicators or technical writers. These individuals use a set of methods to research, document, and present technical processes or products. Technical communicators may put the information they capture into paper documents, web pages, computer-based training, digitally stored text, audio, video, and other media. The Society for Technical Communication defines the field as any form of communication that focuses on technical or specialized topics, communicates specifically by using technology, or provides instructions on how to do something.What is Technical Communicatio ...
[...More Info...]      
[...Related Items...]     OR:     [Wikipedia]   [Google]   [Baidu]  


Modularity
Broadly speaking, modularity is the degree to which a system's components may be separated and recombined, often with the benefit of flexibility and variety in use. The concept of modularity is used primarily to reduce complexity by breaking a system into varying degrees of interdependence and independence across and "hide the complexity of each part behind an abstraction and interface". However, the concept of modularity can be extended to multiple disciplines, each with their own nuances. Despite these nuances, consistent themes concerning modular systems can be identified. Contextual nuances The meaning of the word "modularity" can vary somewhat based on context. The following are contextual examples of modularity across several fields of science, technology, industry, and culture: Science *In biology, modularity recognizes that organisms or metabolic pathways are composed of modules. *In ecology, modularity is considered a key factor—along with diversity and feedback—in ...
[...More Info...]      
[...Related Items...]     OR:     [Wikipedia]   [Google]   [Baidu]  


Digital Content Creation
Content creation is the contribution of information to any media and most especially to digital media for an end-user/audience in specific contexts. Content is "something that is to be expressed through some medium, as speech, writing or any of various arts" for self-expression, distribution, marketing and/or publication. Typical forms of content creation include maintaining and updating web sites, blogging, article writing, photography, videography, online commentary, the maintenance of social media accounts, and editing and distribution of digital media. A Pew survey described content creation as the creation of "the material, people contribute to the online world." Content creators News organizations News organizations, especially the biggest and more international, such as ''The New York Times,'' NPR, and CNN and others, consistently create some of the most shared content on the Web. This is especially true for content-related breaking news and topical events. In the wo ...
[...More Info...]      
[...Related Items...]     OR:     [Wikipedia]   [Google]   [Baidu]  




Discourse Topic
A discourse topic is the central participant or idea of a stretch of connected discourse or dialogue. The ''topic'' is what the discourse is about. The notion is often confused with the related notion of sentence-level topic/theme, which is frequently defined as "what the sentence is about". Discourse topics have been of considerable interest to linguists because of the relations between the topic of a discourse and various aspects of the grammatical structure of the sentence, including strategies for referent-tracking (including the use of voice, inversion Inversion or inversions may refer to: Arts * , a French gay magazine (1924/1925) * ''Inversion'' (artwork), a 2005 temporary sculpture in Houston, Texas * Inversion (music), a term with various meanings in music theory and musical set theory * ...,Zúñiga, Fernando (2006) ''Deixis and Alignment. Inverse systems in indigenous languages of the Americas.'' Amsterdam: John Benjamins. switch-reference markers, and obviation), ...
[...More Info...]      
[...Related Items...]     OR:     [Wikipedia]   [Google]   [Baidu]  


picture info

XHTML
Extensible HyperText Markup Language (XHTML) is part of the family of XML markup languages. It mirrors or extends versions of the widely used HyperText Markup Language (HTML), the language in which Web pages are formulated. While HTML, prior to HTML5, was defined as an application of Standard Generalized Markup Language (SGML), a flexible markup language framework, XHTML is an application of XML, a more restrictive subset of SGML. XHTML documents are well-formed and may therefore be parsed using standard XML parsers, unlike HTML, which requires a lenient HTML-specific parser. XHTML 1.0 became a World Wide Web Consortium (W3C) recommendation on 26 January 2000. XHTML 1.1 became a W3C recommendation on 31 May 2001. The standard known as XHTML5 is being developed as an XML adaptation of the HTML5 specification. Overview XHTML 1.0 is "a reformulation of the three HTML 4 document types as applications of XML 1.0". The World Wide Web Consortium (W3C) also continues to maintai ...
[...More Info...]      
[...Related Items...]     OR:     [Wikipedia]   [Google]   [Baidu]  


picture info

Reuse
Reuse is the action or practice of using an item, whether for its original purpose (conventional reuse) or to fulfill a different function ( creative reuse or repurposing). It should be distinguished from recycling, which is the breaking down of used items to make raw materials for the manufacture of new products. Reuse – by taking, but not reprocessing, previously used items – helps save time, money, energy and resources. In broader economic terms, it can make quality products available to people and organizations with limited means, while generating jobs and business activity that contribute to the economy. Examples Reuse centers and virtual exchange These services facilitate the transaction and redistribution of unwanted, yet perfectly usable, materials and equipment from one entity to another. The entities that benefit from either side of this service (as donors, sellers, recipients, or buyers) can be businesses, nonprofits, schools, community groups, and individuals. S ...
[...More Info...]      
[...Related Items...]     OR:     [Wikipedia]   [Google]   [Baidu]  


Content Management
Content management (CM) is a set of processes and technologies that supports the collection, managing, and publishing of information in any form or medium. When stored and accessed via computers, this information may be more specifically referred to as digital content, or simply as content. * Digital content may take the form of text (such as electronic documents), images, multimedia files (such as audio or video files), or any other file type that follows a content lifecycle requiring management. * The process of content development and management and is complex enough that various commercial software vendors (large and small), such as Interwoven and Microsoft, offer content management software to control and automate significant aspects of the content lifecycle. Process Content management practices and goals vary by mission and by organizational governance structure. News organizations, e-commerce websites, and educational institutions all use content management, but in di ...
[...More Info...]      
[...Related Items...]     OR:     [Wikipedia]   [Google]   [Baidu]  


Darwin Information Typing Architecture
The Darwin Information Typing Architecture (DITA) specification defines a set of document types for authoring and organizing topic-oriented information, as well as a set of mechanisms for combining, extending, and constraining document types. It is an open standard that is defined and maintained by the OASIS DITA Technical Committee. The name derives from the following components: * Darwin: it uses the principles of specialization and inheritance, which is in some ways analogous to the naturalist Charles Darwin's concept of evolutionary adaptation, * Information Typing: which means each topic has a defined primary objective (procedure, glossary entry, troubleshooting information) and structure, * Architecture: DITA is an extensible set of structures. Features and limitations Content reuse Topics are the foundation for content reuse, and can be reused across multiple publications. Fragments of content within topics can be reused through the use of content references (''conref'' o ...
[...More Info...]      
[...Related Items...]     OR:     [Wikipedia]   [Google]   [Baidu]  


picture info

Organization For The Advancement Of Structured Information Standards
The Organization for the Advancement of Structured Information Standards (OASIS; ) is a nonprofit consortium that works on the development, convergence, and adoption of open standards for cybersecurity, blockchain, Internet of things (IoT), emergency management, cloud computing, legal data exchange, energy, content technologies, and other areas. History OASIS was founded under the name "SGML Open" in 1993. It began as a trade association of Standard Generalized Markup Language (SGML) tool vendors to cooperatively promote the adoption of SGML through mainly educational activities, though some amount of technical activity was also pursued including an update of the CALS Table Model specification and specifications for fragment interchange and entity management. In 1998, with the movement of the industry to XML, SGML Open changed its emphasis from SGML to XML, and changed its name to OASIS Open to be inclusive of XML and reflect an expanded scope of technical work and st ...
[...More Info...]      
[...Related Items...]     OR:     [Wikipedia]   [Google]   [Baidu]  


Component Content Management System
A component content management system (CCMS) is a content management system that manages content at a granular level (component) rather than at the document level. Each component represents a single topic, concept or asset (for example an image, table, product description, a procedure). Overview The CCMS must be able to track "not only versions of topics and graphics but relationships among topics, graphics, maps, publications, and deliverables." More often than not, the CCMS also contains the publishing engine to create the final outputs for print, web and e-readers. Components can be as large as a chapter or as small as a definition or even a word. Components in multiple content assemblies (content types) can be viewed as components or as traditional documents. Although modular documentation is not necessarily XML-based, it is usually the case. Standards include: * Darwin Information Typing Architecture (DITA) (generic and adaptable) * DocBook (generic) * S1000D (defense ...
[...More Info...]      
[...Related Items...]     OR:     [Wikipedia]   [Google]   [Baidu]  




Structured Writing
Structured writing is a form of technical writing that uses and creates structured documents. The term was coined by Robert E. Horn and became a central part of his information mapping method of analyzing, organizing, and displaying knowledge in print and in the new online presentation of text and graphics. Horn and colleagues identified dozens of common documentation types, then analyzed them into structural components called information blocks. They identified over 200 common block types. These were assembled into information types using information maps. The seven most common information types were concept, procedure, process, principle, fact, structure, and classification. Some of the problems that structured writing addresses Structured writing has been developed to address common problems in complex writing: * Organizing large amounts of material * Maintaining an orderly structure to provide a consistent experience to users * Providing users with a more intuitive and o ...
[...More Info...]      
[...Related Items...]     OR:     [Wikipedia]   [Google]   [Baidu]  


Simplified Technical English
ASD-STE100 Simplified Technical English (STE) is an international specification for the preparation of technical documentation in a controlled language. STE as a controlled language was developed in the early 1980s (as AECMA Simplified English) to help second-language speakers of English to unambiguously understand technical manuals written in English. It was initially applicable to civil aircraft maintenance documentation. It then became a requirement for defense projects, including land and sea vehicles. Today, many maintenance and technical manuals are written in STE, in a wide range of other industries. History The first attempts towards a form of controlled English were made as early as the 1930s and 1970s with Basic English and Caterpillar Fundamental English. In 1979 aerospace documentation was written in American English (Boeing, Douglas, Lockheed, etc.), in British English (Hawker Siddeley, British Aircraft Corporation, etc.) and by companies whose native language was no ...
[...More Info...]      
[...Related Items...]     OR:     [Wikipedia]   [Google]   [Baidu]