Documentation/Maemo Documentation Guidelines/Maemo document structure
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.