Documentation/Maemo Documentation Guidelines/Maemo document structure


Revision as of 08:48, 9 April 2010

Maemo document structure

A typical Maemo document has the following structure:

Cover page
 Preface
 Table of Contents
 List of Figures
 List of Tables
 Glossary
 Chapter Introduction
 - introduction to the whole document
 Chapter AAAAAA
 Section Introduction
 - introduction to the chapter
 - links to example applications
 - links to API documents
 Section BBBBBB
 SubSection bbbbbb
 SubSubSection dddddd
 Paragraph pppppp
 Section CCCCCC
 Section Summary
 - summary of the chapter
 - links for further reading
 Chapter XXXXXX
 Section Introduction
 - introduction to the chapter
 - links to example applications
 - links to API documents
 Section YYYYYY
 Section Summary
 - summary of the chapter
 - links for further reading
 Bibliography
 Appendix

The document structure given below assumes that each document chapter (except Introduction chapter for the whole document) is independent from other chapters and can be reused also for other documents, if needed.

Cover page
must have title, publishing date and references to both Nokia Corporation and maemo.org. Cover page will not be included to the table of contents.
Preface
must be based on tempates available as appendixes for this Maemo Documentation Guidelines document. Base license must be GNU Free Documentation License, version 1.2 and if document includes code examples copyrighted by Nokia they must use MIT-style license. Preface will not be included to the table of contents.
List of Figures and Tables
chapters are optional, for PDF documents only and will not be included to the table of contents.
Glossary
chapter is optional and will not be included to the table of contents.
Introduction
chapter for the whole document and sections for each chapter are mandatory and they do not have Subsections. Introduction section for each chapter must include links to supporting example applications and API documents used in that chapter.
Chapter
always starts from a new page and is independent from other chapters. Chapters can have four different level sections in their internal structure.
Summary
section for each chapter is optional but if used, should give reader links for further reading.
Bibliography
chapter is optional.
Appendix
chapters are optional. Each appendix must start from new page.