3. MAIN SECTIONS OF A DOCUMENTATION
Methodologies
Literature
Review
System
Analysis
Introductory
& Final Pages
Discussion &
Results
Conclusion
Presenting your project made easy
4. INTRODUCTORY PAGES
Front Page (Main Cover).
Mansoura University’s logo, Computer and Control Systems
Department, Project’s Title, Supervisors Name (s), Team Members
Names, Date (M/Y), Sponsors’ logos, and …
This phrase: “A Graduation Project Submitted in the partial
fulfillment of B.S. degree in Computer Science & Information
Systems.”
Qur’anic Verse / Quote …
Presenting your project made easy
5. ABSTRACT
Abstract (Preface) …
An Abstract shouldn’t exceed about 200 – 500 words in a paper,
and about 2 pages (Maximum) in a Documentation.
The English Abstract should be translated at least into “Arabic.”
Do not cite references in the abstract.
Presenting your project made easy
6. ACKNOWLEDGMENT & DEDICATIONS
Acknowledgment
The preferred spelling of the word “acknowledgment” in American
English is without an “e” after the “g.”
Use the singular heading even if you have many acknowledgments.
Avoid expressions such as “One of us (S.B.A.) would like to thank ...
.” Instead, write “F. A. Author thanks ... .”
Dedications
Presenting your project made easy
7. THE REMAINING INTRODUCTORY
PAGES
Table of Contents
List of …
Figures.
Tables.
Equations. (Optional)
Abbreviations. (Optional)
Document Organization (Structure)
Chapter 1: Introduction which usually
includes sections such as Overview, Motivation, Problem
Statement, Objective (s), Scope of the work, Solution
Approaches, Tools Used, … etc.
Presenting your project made easy
8. CONTENTS OF A LITERATURE REVIEW
Reviewing the different scopes and related domains.
Reviewing main modules in the selected scope.
Reviewing the main approaches and methodologies per module
State implicitly/briefly the Advantages/Disadvantages as reviewed
for each approach.
A simple indirect comparative study may be conducted (in tables
form).
At least one chapter in the documentation, but may reach three.
An example to illustrate all aspects of literature review: Voice
Recognition
Presenting your project made easy
9. METHODOLOGIES (PROPOSED SYSTEM)
Detail the researched & implemented methods.
Determine the scope of the project in more details.
Use appendices to make a better document structure.
Detail any comparative aspects with other approaches.
Presenting your project made easy
10. SYSTEM ANALYSIS & DESIGN
Only one chapter.
Block Diagram.
Requirements Specification: System’s Software & Hardware
Requirements.
Assumptions & Dependencies.
Software lifecycle and time plan.
UML (Unified Modeling Language) Diagrams.
e.g. Use Case Diagram, Class Diagram, Sequence Diagram,
Collaboration Diagram, Activity Diagram, State Machine Diagram,
… etc.
Presenting your project made easy
12. DISCUSSION & CONCLUSION
Discuss the achieved results.
Conclude/Summarize the contributions.
A conclusion section is not required. Although a conclusion may
review the main points of the paper.
Do not replicate the abstract as the conclusion.
A conclusion might elaborate on the importance of the work or
suggest applications and extensions.
Future Work.
Presenting your project made easy
13. THE REMAINING FINAL PAGES
References
Appendices
Glossary
Notes
Presenting your project made easy
14. GENERAL GUIDELINES & STANDARDS
Nearly all pages should be numbered (Roman/English numbers).
Not more than a couple of – formal – fonts per page.
Standard indexing & font sizes for paragraphs, sub-titles, sections’
titles, and chapters’ titles (e.g. 12, 14, 16 and 22).
Don’t write a paragraph consisting of one line.
Usually, in documentations, roman numerals are used only in
numbering the introductory pages … English numbers are used
to number the whole document starting the chapters.
Define all symbols and abbreviations before using them (whether in
text or list of abbreviations).
Presenting your project made easy
15. GENERAL GUIDELINES & STANDARDS
Figures, Tables, and Equations should be indexed, and they have to
be referred to within the text.
Figure explanation should be below the figures; table explanations
should be above the tables.
Avoid placing figures and tables before their first mention in the text.
Use the abbreviation “Fig. 1,” even at the beginning of a sentence.
Do not change the font sizes or line spacing to compress more text
into a limited number of pages.
Use italics for ensuring ; do not underline.
Presenting your project made easy
16. GENERAL GUIDELINES & STANDARDS
If you are using Word, use either the Microsoft Equation Editor or the
MathType add-on (http://www.mathtype.com) for equations in
your paper/document (Insert | Object | Create New | Microsoft
Equation or MathType Equation).
Use one space after complete sentence and colons.
Avoid dangling participles, such as, “Using (1), the potential was
calculated.” [It is not clear who or what used (1).] Write instead,
“The potential was calculated by using (1),” or “Using (1), we
calculated the potential.”
Use a zero before decimal points: “0.25,” not “.25.”
Indicate sample dimensions as “0.1 cm × 0.2 cm,” not “0.1 × 0.2
cm2.”
Presenting your project made easy
17. GENERAL GUIDELINES & STANDARDS
The abbreviation for “seconds” is “s,” not “sec.”
Do not mix complete spellings and abbreviations of units: use
“Wb/m2” or “webers per square meter,” not “webers/m2.”
When expressing a range of values, write “7 to 9” or “7-9,” not
“7~9.”
A parenthetical statement at the end of a sentence is punctuated
outside of the closing parenthesis (like this). (A parenthetical
sentence is punctuated within the parentheses)
Presenting your project made easy
18. GENERAL GUIDELINES & STANDARDS
Avoid contractions; for example, write “do not” instead of “don’t.”
The serial comma is preferred: “A, B, and C” instead of “A, B and C.”
If you wish, you may write in the first person singular or plural and
use the active voice (“I observed that ...” or “We observed that ...”
instead of “It was observed that ...”).
Remember to check spelling.
Presenting your project made easy
19. SOME COMMON MISTAKES
The word “data” is plural, not singular.
The subscript for the permeability of vacuum µ0 is zero, not a
lowercase letter “o.”
Use the word “whereas” instead of “while” (unless you are referring
to simultaneous events).
Do not use the word “essentially” to mean “approximately” or
“effectively.”
Do not use the word “issue” as a euphemism for “problem.”
Presenting your project made easy
20. SOME COMMON MISTAKES
Be aware of the different meanings of the homophones “affect”
(usually a verb) and “effect” (usually a noun), “complement” and
“compliment,” “discreet” and “discrete,” “principal” (e.g.,
“principal investigator”) and “principle” (e.g., “principle of
measurement”).
Prefixes such as “non,” “sub,” “micro,” “multi,” and “ultra” are not
independent words; they should be joined to the words they
modify, usually without a hyphen “nonlinear” “non-linear”
The abbreviation “i.e.,” means “that is,” and the abbreviation “e.g.,”
means “for example” (these abbreviations are not italicized).
Presenting your project made easy