JDOC:Modular documentation - Revision history

JoomlaWikiBot: /* Further Reading */clean up

2013-03-16T15:07:06Z

‎Further Reading: clean up

Bysukro at 14:31, 16 March 2013

2013-03-16T14:31:21Z

Mvangeest: Modular Documentation moved to JDOC:Modular documentation: Implemented part of the RFC suggestions at JDOC talk:Modular documentation

2011-02-02T21:00:26Z

Modular Documentation moved to JDOC:Modular documentation: Implemented part of the RFC suggestions at JDOC talk:Modular documentation

Chris Davenport at 23:11, 31 December 2007

2007-12-31T23:11:22Z

Chris Davenport: Replacing page with '{{Introduction to Modular Documentation}}'

2007-12-31T23:08:47Z

Replacing page with '{{Introduction to Modular Documentation}}'

Chris Davenport: New page: The idea behind modular documentation is very simple: we develop content in re-usable modules that can be assembled into finished documents in different formats such as web tutorials, onli...

2007-12-31T23:04:20Z

New page: The idea behind modular documentation is very simple: we develop content in re-usable modules that can be assembled into finished documents in different formats such as web tutorials, onli...

New page

The idea behind modular documentation is very simple: we develop content in re-usable modules that can be assembled into finished documents in different formats such as web tutorials, online help systems and printed manuals. We will create a database of re-usable modules in this wiki so that we have a single source from which we can derive documents for different audiences and different purposes.

The key to modular documentation is modular writing. That is, each module is written as an independent, context-free element. In this context each module (which we shall often refer to as a "chunk") is a single wiki page.

The process of building a modular document is cyclical. We generate output documents from the source chunks and having seen what they look like we then modify the source chunks until we achieve the desired results. Since we are using the MediaWiki transclusion mechanism, document assembly is effectively instant and so this cyclical process can be very rapid. We can export content from the wiki to produce documents in other formats such as DocBook XML, PDF and CHM.

Each chunk is a small, focussed, stand-alone piece of content that is written so that it makes sense even when taken out of context. Each chunk can be thought of as answering a basic question (who?, what?, where?, when?, why?, how?) and we categorise the chunks according to the type of answer we are giving (for example, a topic, procedure, definition, figure or table).

As more and more chunks are created it becomes increasingly important to have some means of finding them again. To assist this process each chunk is "categorised", meaning that several tags describing its content are added to it. Category indexes are automatically generated by the MediaWiki code.

@@ Line 6: / Line 6: @@
 ==Further Reading==
 {{Further Reading on Modular Documentation}}
-[[Category:JDOC Projects]]
+<noinclude>[[Category:Documentation Wiki Information]]</noinclude>

← Older revision		Revision as of 14:31, 16 March 2013
Line 6:		Line 6:
	==Further Reading==		==Further Reading==
	{{Further Reading on Modular Documentation}}		{{Further Reading on Modular Documentation}}
		+	[[Category:JDOC Projects]]

← Older revision		Revision as of 23:11, 31 December 2007
Line 1:		Line 1:
	{{Introduction to Modular Documentation}}		{{Introduction to Modular Documentation}}
		+
		+	==Transclusion==
		+	{{Introduction to Transclusion}}
		+
		+	==Further Reading==
		+	{{Further Reading on Modular Documentation}}

@@ Line 1: / Line 1: @@
-The idea behind modular documentation is very simple: we develop content in re-usable modules that can be assembled into finished documents in different formats such as web tutorials, online help systems and printed manuals. We will create a database of re-usable modules in this wiki so that we have a single source from which we can derive documents for different audiences and different purposes.
+{{Introduction to Modular Documentation}}
-−
-The key to modular documentation is modular writing. That is, each module is written as an independent, context-free element. In this context each module (which we shall often refer to as a "chunk") is a single wiki page.
-−
-The process of building a modular document is cyclical. We generate output documents from the source chunks and having seen what they look like we then modify the source chunks until we achieve the desired results. Since we are using the MediaWiki transclusion mechanism, document assembly is effectively instant and so this cyclical process can be very rapid. We can export content from the wiki to produce documents in other formats such as DocBook XML, PDF and CHM.
-−
-Each chunk is a small, focussed, stand-alone piece of content that is written so that it makes sense even when taken out of context. Each chunk can be thought of as answering a basic question (who?, what?, where?, when?, why?, how?) and we categorise the chunks according to the type of answer we are giving (for example, a topic, procedure, definition, figure or table).
-−
-As more and more chunks are created it becomes increasingly important to have some means of finding them again. To assist this process each chunk is "categorised", meaning that several tags describing its content are added to it.  Category indexes are automatically generated by the MediaWiki code.