Skip to content

Commit

Permalink
Update ka_BooksStructure.rst
Browse files Browse the repository at this point in the history
  • Loading branch information
Alessandro committed May 18, 2018
1 parent 88ad5d9 commit e4f5442
Showing 1 changed file with 19 additions and 47 deletions.
66 changes: 19 additions & 47 deletions common/ka_BooksStructure.rst
Original file line number Diff line number Diff line change
@@ -1,72 +1,44 @@
Documentation structure
Before starting
===========================

Documentation structure
-----------------

Knowage documentation is composed by:

- **Installation Manual**;

- **General User Manual**;

- **General Administrator Manual**;

- one more book for each product purchased.

The books focusing on products describe all the BI functionalities
included in your installation. For example if you have purchased
KnowageBD subscription, you will get the installation and the two
general manuals plus a third one which focus on the BI functionalities
provided by this product.
The books focusing on products describe all the BI functionalities included in your installation. For example if you have purchased KnowageBD subscription, you will get the installation and the two general manuals plus a third one which focus on the BI functionalities provided by this product.

Target
======
-----------------

Each book is thought to be delivered to different users.

- **Installation Manual**: it is aimed at technical users. It provides
all the instructions needed to install and configure the Knowage
suite. Here the essential steps to succeed with the standard
installation on certified environments will be described, including
the optional use of CAS as a SSO solution and the use of HTTPS
protocol.

- **General User Manual**: it is aimed at end users. It provides a
first approach to Knowage interface and functionalities. It can be
used as a first approach to Knowage. It focus on all those elements
which are shared among the products and involves the end user.

- **General Administrator Manual**: it is aimed at Knowage
admnistrator. It describes all the management and configuration tools
shared by all Knowage products.

- **Product Manuals**: as we mentioned above, these books are specific
for each product. They are aimed both at end users and Knowage
developers. Almost each chapter is divided in two parts: the first
one can be interesting for both users and developers, while the
second one is for developers only. The developer parts are marked by
a \* to be easy recognised. We can conlcude that you just need to
read all the parts not marked by \* to have a complete introduction
to all BI functionalities included in your products.
- **Installation Manual**: it is aimed at technical users. It provides all the instructions needed to install and configure the Knowage suite. Here the essential steps to succeed with the standard installation on certified environments will be described, including the optional use of CAS as a SSO solution and the use of HTTPS protocol.

- **General User Manual**: it is aimed at end users. It provides a first approach to Knowage interface and functionalities. It can be used as a first approach to Knowage. It focus on all those elements which are shared among the products and involves the end user.

- **General Administrator Manual**: it is aimed at Knowage admnistrator. It describes all the management and configuration tools shared by all Knowage products.

- **Product Manuals**: as we mentioned above, these books are specific for each product. They are aimed both at end users and Knowage developers. Almost each chapter is divided in two parts: the first one can be interesting for both users and developers, while the second one is for developers only. The developer parts are marked by a \* to be easy recognised. We can conlcude that you just need to
read all the parts not marked by \* to have a complete introduction to all BI functionalities included in your products.

About conventions
=================
-----------------

Some graphical conventions have been adopted to allow readers to easily
identify special contents such as notes, summaries and essential
information. All conventions are explained hereafter.
Some graphical conventions have been adopted to allow readers to easily identify special contents such as notes, summaries and essential information. All conventions are explained hereafter.

|image0|

Documentation structure


The following fonts have been adopted, to easily identify special words
and expressions:

- **Menu**, **Menu items** and **static label** refer to specific
element of Knowage GUI;

- **Menu**, **Menu items** and **static label** refer to specific element of Knowage GUI;
- Input field is a label referencing input fields in Knowage GUI;

- Code example is a piece of code showing configuration patterns or
parts of document template.

..
- Code example is a piece of code showing configuration patterns or parts of document template.

0 comments on commit e4f5442

Please sign in to comment.