0% found this document useful (0 votes)
59 views9 pages

Work Sample

This document provides a template for a user manual for an application called Project XXX. It includes sections for describing the purpose and history of the document, distribution of the manual, validation information, icons used in the manual, presentation of the application including description, players, support, documentation and history. It also includes sections for connecting to the application, structuring of the application including layout, menus, icons/shortcuts and functionalities. The bulk of the document focuses on providing screenshots and step-by-step descriptions of specific application functions and screens.

Uploaded by

Jasmine Aluciman
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as DOC, PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
59 views9 pages

Work Sample

This document provides a template for a user manual for an application called Project XXX. It includes sections for describing the purpose and history of the document, distribution of the manual, validation information, icons used in the manual, presentation of the application including description, players, support, documentation and history. It also includes sections for connecting to the application, structuring of the application including layout, menus, icons/shortcuts and functionalities. The bulk of the document focuses on providing screenshots and step-by-step descriptions of specific application functions and screens.

Uploaded by

Jasmine Aluciman
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as DOC, PDF, TXT or read online on Scribd
You are on page 1/ 9

<APPLICATION / PROJECT XXX>

<USER MANUAL TEMPLATE >

Document type :
 draft
 to be validated
 validated

Reference : 471010027.doc

< Do not forget to fill in the properties in WORD :


 Document title
 Subjet
 Autor
 Comments
…>

Purpose of the document

<The purpose of this document is to describe the application


supplied to the user>

This document is the property of the Council of Europe.


It may not be reproduced or communicated without the author's prior agreement.

471010027.doc [<Application / Project XXX>]


Last modification 13 avril 2020 à 12:15:00
Author  DIT Version : 1.0 Page 1 / 9
Document history

Version Date Drafter Description

Distribution

For For
Receiver
validation information

Validation

Representative Validator Date


Contents

PURPOSE OF THE DOCUMENT 1


DOCUMENT HISTORY 2
DISTRIBUTION 2
VALIDATION 2
1. ICONS USED IN THE MANUEL 4
2. PRESENTATION OF THE SOLUTION 4
2.1 Brief description 4
2.2 Descriptives Icons 4
2.3 Project players 4
2.4 Support 5
2.5 Referenced Documentation 5
2.6 History of the Solution 5
3. CONNECTING TO THE APPLICATION 6
3.1 Address 6
3.2 Authentication 6
4. STRUCTURING OF THE APPLICATION 6
4.1 Layout 6
4.2 Menus 7
4.3 Icons / Shortcuts 7
4.4 Functionalities 7
4.4.1 Functionalities Presented/Described 7
4.4.2 Functionalities not Presented/not Described 7
5. FUNCTION XXX / SCREEN XXX 7
5.1 Screenshot 7
5.2 Descriptions of fields, content 8
5.3 Description of actions 8
5.4 Sequence of screens 8
6. FUNCTION XXX / SCREEN XXX 8
6.1 Screenshot 8
6.2 Descriptions of fields, content 8
6.3 Description of actions 8
6.4 Sequence of screens 9
7. APPENDICES 9
7.1 Appendix 1 9
7.2 Appendix 2 9
1. ICONS USED IN THE MANUEL
Throughout this document, the pictograms below are used to underline points or important notions

Important information

Good to know - Tricks

Risk in front of a parameter setting or of a specific action

Action to be avoided

Mandatory action

Sensitive or difficult procedure. To take into account necessarily

Actions reserved for the …. < Adapt the vocabulary according to the application
(administrator, manager, etc. >

Actions reserved for the … < Adapt the vocabulary according to the application
(user, publisher, etc. >

2. PRESENTATION OF THE SOLUTION

2.1 BRIEF DESCRIPTION

<Give an outline description here>

2.2 DESCRIPTIVES ICONS

<Add if necessary, a table listing the specific signalling system to the application (icons, buttons and
associated actions).
Delete section so useless. >

2.3 PROJECT PLAYERS

<List all the players impacted by the project/solution here:


 Owner of the application
 Owner of the data

>
2.4 SUPPORT

<List what is needed for a support request here:


 Telephone
 E-mail
 Dedicated application
 …

Describe how to track the progress of the request in order to avoid excessive telephoning>

2.5 REFERENCED DOCUMENTATION

<Some documentation may be useful to the user in helping them understand how application-related
modules work.
List them here if applicable.
>

2.6 HISTORY OF THE SOLUTION

<Give the background here to the various stages in developing the solution from a user viewpoint.>
3. CONNECTING TO THE APPLICATION

3.1 ADDRESS

You must connect to the application using the following address:


<Insert the application's URL here>

3.2 AUTHENTICATION

<Indicate here what information must be given by the user to log on: login AD, surname first name, e-mail
address etc
Insert a screenshot of the authentication page.

Explain and show a screenshot of the page refusing unauthorised access. >

4. STRUCTURING OF THE APPLICATION

4.1 LAYOUT

<For a web application describe the structuring of the pages if they follow the same pattern.
An example is given below.>

Application XXX
Icônes// Shorcuts
Icons Raccourcis

Processing area
Zone de traitement
Menu
4.2 MENUS

<List the menus, shown in tree-structure >

4.3 ICONS / SHORTCUTS

<Show each icon or shortcut, together with a description. >

4.4 FUNCTIONALITIES

4.4.1 FUNCTIONALITIES PRESENTED/DESCRIBED

<List here all the functionalities that will be described in the document.
You could group together a number of similar functions or functionalities linked within a workflow for
example. These groupings should be shown here to give the user the map they need to read the document. >

4.4.2 FUNCTIONALITIES NOT PRESENTED/NOT DESCRIBED

<List here all the functionalities that will not be described in the document.

It is not necessary to present all the functionalities of an application:


 because it is already described elsewhere: you could insert a link or reference etc
 because the functionality is unimportant
 …

>

5. FUNCTION XXX / SCREEN XXX

<Description of the functionality >

5.1 SCREENSHOT

<Not absolutely necessary but often very useful, with arrowed explanations, and boxing or circling of
different fields for user input or presentation>
5.2 DESCRIPTIONS OF FIELDS, CONTENT

<Show the fields, particularly the mandatory fields, and/or the input masks which are checked
Show the colour codes if there are any.
Show the lists and explain their content
…>

5.3 DESCRIPTION OF ACTIONS

<Explain the actions possible for the given screen, and the consequences, without reproducing the
functional specifications.
Nevertheless it may prove useful, if not necessary, to reiterate a business rule or management rule.>

5.4 SEQUENCE OF SCREENS

<If necessary show the sequence of screens.>

6. FUNCTION XXX / SCREEN XXX

<Description of the functionality >

6.1 SCREENSHOT

<Not absolutely necessary but often very useful, with arrowed explanations, and boxing or circling of
different fields for user input or presentation>

6.2 DESCRIPTIONS OF FIELDS, CONTENT

<Show the fields, particularly the mandatory fields, and/or the input masks which are checked
Show the colour codes if there are any.
Show the lists and explain their content
…>

6.3 DESCRIPTION OF ACTIONS

<Explain the actions possible for the given screen, and the consequences, without reproducing the
functional specifications.
Nevertheless it may prove useful, if not necessary, to reiterate a business rule or management rule.>

6.4 SEQUENCE OF SCREENS

<If necessary show the sequence of screens.>


7. APPENDICES

7.1 APPENDIX 1

<Give here any additional information that could make the functional specifications easier to understand.>

7.2 APPENDIX 2

End of document

You might also like