svn commit: r1708733 - in /syncope/site/2.0.0-SNAPSHOT/docs: getting-started.html getting-started.pdf reference-guide.html reference-guide.pdf

[il...@apache.org]

Author: ilgrosso
Date: Thu Oct 15 06:47:44 2015
New Revision: 1708733

URL: http://svn.apache.org/viewvc?rev=1708733&view=rev
Log:
[SYNCOPE-700] Publish updates after first grammar fixes by Colm in http://git-wip-us.apache.org/repos/asf/syncope/commit/ae88f405

Modified:
    syncope/site/2.0.0-SNAPSHOT/docs/getting-started.html
    syncope/site/2.0.0-SNAPSHOT/docs/getting-started.pdf
    syncope/site/2.0.0-SNAPSHOT/docs/reference-guide.html
    syncope/site/2.0.0-SNAPSHOT/docs/reference-guide.pdf

Modified: syncope/site/2.0.0-SNAPSHOT/docs/getting-started.html
URL: http://svn.apache.org/viewvc/syncope/site/2.0.0-SNAPSHOT/docs/getting-started.html?rev=1708733&r1=1708732&r2=1708733&view=diff
==============================================================================
--- syncope/site/2.0.0-SNAPSHOT/docs/getting-started.html (original)
+++ syncope/site/2.0.0-SNAPSHOT/docs/getting-started.html Thu Oct 15 06:47:44 2015
@@ -426,8 +426,8 @@ body.book #toc,body.book #preamble,body.
 <ul class="sectlevel1">
 <li><a href="#introduction">1. Introduction</a>
 <ul class="sectlevel2">
-<li><a href="#what-is-this-identity-management-anyway">1.1. What is this Identity Management, anyway?</a></li>
-<li><a href="#bird-s-eye-view-on-architecture">1.2. Bird&#8217;s eye view on Architecture</a></li>
+<li><a href="#what-is-identity-management-anyway">1.1. What is Identity Management, anyway?</a></li>
+<li><a href="#a-bird-s-eye-view-on-the-architecture-of-apache-syncope">1.2. A bird&#8217;s eye view on the Architecture of Apache Syncope</a></li>
 </ul>
 </li>
 <li><a href="#system-requirements">2. System Requirements</a>
@@ -511,25 +511,25 @@ compliance.</p>
 <div class="sectionbody">
 <div class="paragraph">
 <p><strong>Apache Syncope</strong> is an Open Source system for managing digital identities in enterprise environments, implemented in
-Java EE technology and released under Apache 2.0 license.</p>
+Java EE technology and released under the Apache 2.0 license.</p>
 </div>
 <div class="paragraph">
-<p><strong>Identity management</strong> (or IdM) represents the joint result of business process and IT to manage user data on systems and
-applications. IdM involves considering user attributes, roles, resources and entitlements in trying to give a decent
-answer to the question bumping up every time in an IT administrator&#8217;s mind:</p>
+<p><strong>Identity Management</strong> (or IdM) means to manage user data on systems and applications, using the combination of
+business processes and IT. IdM involves considering user attributes, roles, resources and entitlements in trying to answer the
+following thorny question:</p>
 </div>
 <div class="paragraph text-center">
 <p><em>Who has access to What, When, How, and Why?</em></p>
 </div>
 <div class="sect2">
-<h3 id="what-is-this-identity-management-anyway"><a class="anchor" href="#what-is-this-identity-management-anyway"></a>1.1. What is this Identity Management, anyway?</h3>
+<h3 id="what-is-identity-management-anyway"><a class="anchor" href="#what-is-identity-management-anyway"></a>1.1. What is Identity Management, anyway?</h3>
 <div class="sidebarblock">
 <div class="content">
 <div class="dlist">
 <dl>
 <dt class="hdlist1">Account</dt>
 <dd>
-<p>Computers work with records of data about persons. Such records contains technical information needed by the system for
+<p>Computers work with records of data about people. Such records contain technical information needed by the system for
 which the account is created and managed.</p>
 </dd>
 <dt class="hdlist1">(Digital) Identity</dt>
@@ -541,17 +541,17 @@ which the account is created and managed
 </div>
 </div>
 <div class="paragraph">
-<p>Have you ever been hired by a company, entered an organization or just subscribed a new Google account?
+<p>Have you ever been hired by a company, entered an organization or just created a new Google account?
 Companies, organizations and cloud entities work with applications that need your data to function properly:
 username, password, e-mail, first name, surname, and more.</p>
 </div>
 <div class="paragraph">
-<p>Who is going to feed such information? And what happens when you need to be enabled for more applications? And what if
+<p>Where is this information going to come from? And what happens when you need to be enabled for more applications? And what if
 you get promoted and acquire more rights on the applications you already had access to?
 Most important, what happens when you quit or they gently let you go?</p>
 </div>
 <div class="paragraph">
-<p>Shortly, Identity Management takes care of managing identity data throughout what is called the <strong>Identity Lifecycle</strong>.</p>
+<p>In brief, Identity Management takes care of managing identity data throughout what is called the <strong>Identity Lifecycle</strong>.</p>
 </div>
 <div class="imageblock text-center">
 <div class="content">
@@ -564,46 +564,46 @@ Most important, what happens when you qu
 <div class="title">Users, groups and any objects</div>
 <div class="paragraph">
 <p>With Apache Syncope 2.0.0, the managed identities are not limited anymore to users and groups. New object types can be
-defined so that any object&#8217;s data can be managed through Syncope: workstations, printers, folders, sensors, services,
-and so on. This positions Apache Syncope at best places for bringing Identity Management in the IoT world.</p>
+defined so that any objects data can be managed through Syncope: workstations, printers, folders, sensors, services,
+and so on. This positions Apache Syncope at the forefront for bringing Identity Management in the IoT world.</p>
 </div>
 </div>
 </div>
 </div>
 <div class="sect2">
-<h3 id="bird-s-eye-view-on-architecture"><a class="anchor" href="#bird-s-eye-view-on-architecture"></a>1.2. Bird&#8217;s eye view on Architecture</h3>
-<div class="paragraph">
+<h3 id="a-bird-s-eye-view-on-the-architecture-of-apache-syncope"><a class="anchor" href="#a-bird-s-eye-view-on-the-architecture-of-apache-syncope"></a>1.2. A bird&#8217;s eye view on the Architecture of Apache Syncope</h3>
+<div class="ulist">
+<ul>
+<li>
 <p><strong><em>Core</em></strong> is the central component, providing all services offered by Apache Syncope.<br>
-It exposes a full-compliant <a href="https://en.wikipedia.org/wiki/Java_API_for_RESTful_Web_Services" target="_blank">JAX-RS 2.0</a>
+It exposes a fully-compliant <a href="https://en.wikipedia.org/wiki/Java_API_for_RESTful_Web_Services" target="_blank">JAX-RS 2.0</a>
 <a href="https://en.wikipedia.org/wiki/Representational_state_transfer" target="_blank">RESTful</a> interface which enables third-party applications,
 written in any programming language, to consume IdM services.</p>
-</div>
-<div class="ulist">
-<ul>
+</li>
 <li>
 <p><strong><em>Logic</em></strong> implements the overall business logic that can be triggered via REST services, and controls some additional
 features (notifications, reports and audit over all)</p>
 </li>
 <li>
-<p><strong><em>Provisioning</em></strong> is delegated to manage the internal (via workflow) and external (via specific connectors)
+<p><strong><em>Provisioning</em></strong> is involved with managing the internal (via workflow) and external (via specific connectors)
 representation of users, groups and any objects.<br>
-Being the crucial decision point for defining and enforcing the consistency and transformations between internal and
-external data, this component needs often to be tailored on requirements of specific deployment. For this reason, besides
-the all-Java default implementation that can be anyway extended, an <a href="http://camel.apache.org/" target="_blank">Apache Camel</a>-based
-implementation is also available as extension, which brings all the power of runtime changes and adaptation.</p>
+This component often needs to be tailored to meet the requirements of a specific deployment, as it is the crucial decision
+point for defining and enforcing the consistency and transformations between internal and external data. The default
+all-Java implementation can be extended for this purpose. In addition, an <a href="http://camel.apache.org/" target="_blank">Apache Camel</a>-based
+implementation is also available as an extension, which brings all the power of runtime changes and adaptation.</p>
 </li>
 <li>
-<p><strong><em>Workflow</em></strong>  is one of pluggable aspects: this lets every deployment choose the preferred engine
-among provided - including the one based on <a href="http://www.activiti.org/" target="_blank">Activiti BPM</a>, the reference open source
+<p><strong><em>Workflow</em></strong>  is one of the pluggable aspects of Apache Syncope: this lets every deployment choose the preferred engine
+from a provided list - including the one based on <a href="http://www.activiti.org/" target="_blank">Activiti BPM</a>, the reference open source
 <a href="http://www.bpmn.org/" target="_blank">BPMN 2.0</a> implementation - or define new, custom ones.</p>
 </li>
 <li>
-<p><strong><em>Persistence</em></strong> manages all data (users, groups, attributes, resources, &#8230;&#8203;) at high level
-using a standard <a href="https://en.wikipedia.org/wiki/Java_Persistence_API" target="_blank">JPA 2.0</a> approach, persisting to an underlying
-database, referred as the <strong><em>Internal Storage</em></strong>. Consistency is ensured via the comprehensive
+<p><strong><em>Persistence</em></strong> manages all data (users, groups, attributes, resources, &#8230;&#8203;) at a high level
+using a standard <a href="https://en.wikipedia.org/wiki/Java_Persistence_API" target="_blank">JPA 2.0</a> approach. The data is persisted to an underlying
+database, referred to as <strong><em>Internal Storage</em></strong>. Consistency is ensured via the comprehensive
 <a href="http://docs.spring.io/spring/docs/4.1.x/spring-framework-reference/html/transaction.html" target="_blank">transaction management</a>
 provided by the Spring Framework.<br>
-Globally, all this permits to scale up to million entities and at the same time allows great portability with no code
+Globally, this offers the ability to easily scale up to a million entities and at the same time allows great portability with no code
 changes: MySQL, MariaDB, PostgreSQL, Oracle and MS SQL Server are fully supported deployment options.</p>
 </li>
 <li>

Modified: syncope/site/2.0.0-SNAPSHOT/docs/getting-started.pdf
URL: http://svn.apache.org/viewvc/syncope/site/2.0.0-SNAPSHOT/docs/getting-started.pdf?rev=1708733&r1=1708732&r2=1708733&view=diff
==============================================================================
Binary files - no diff available.

Modified: syncope/site/2.0.0-SNAPSHOT/docs/reference-guide.html
URL: http://svn.apache.org/viewvc/syncope/site/2.0.0-SNAPSHOT/docs/reference-guide.html?rev=1708733&r1=1708732&r2=1708733&view=diff
==============================================================================
--- syncope/site/2.0.0-SNAPSHOT/docs/reference-guide.html (original)
+++ syncope/site/2.0.0-SNAPSHOT/docs/reference-guide.html Thu Oct 15 06:47:44 2015
@@ -411,97 +411,9 @@ body.book #toc,body.book #preamble,body.
 .show-for-print{display:inherit!important}}
 </style>
 <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.2.0/css/font-awesome.min.css">
-<style>
-/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
-/*pre.CodeRay {background-color:#f7f7f8;}*/
-.CodeRay .line-numbers{border-right:1px solid #d8d8d8;padding:0 0.5em 0 .25em}
-.CodeRay span.line-numbers{display:inline-block;margin-right:.5em;color:rgba(0,0,0,.3)}
-.CodeRay .line-numbers strong{font-weight: normal}
-table.CodeRay{border-collapse:separate;border-spacing:0;margin-bottom:0;border:0;background:none}
-table.CodeRay td{vertical-align: top}
-table.CodeRay td.line-numbers{text-align:right}
-table.CodeRay td.line-numbers>pre{padding:0;color:rgba(0,0,0,.3)}
-table.CodeRay td.code{padding:0 0 0 .5em}
-table.CodeRay td.code>pre{padding:0}
-.CodeRay .debug{color:#fff !important;background:#000080 !important}
-.CodeRay .annotation{color:#007}
-.CodeRay .attribute-name{color:#000080}
-.CodeRay .attribute-value{color:#700}
-.CodeRay .binary{color:#509}
-.CodeRay .comment{color:#998;font-style:italic}
-.CodeRay .char{color:#04d}
-.CodeRay .char .content{color:#04d}
-.CodeRay .char .delimiter{color:#039}
-.CodeRay .class{color:#458;font-weight:bold}
-.CodeRay .complex{color:#a08}
-.CodeRay .constant,.CodeRay .predefined-constant{color:#008080}
-.CodeRay .color{color:#099}
-.CodeRay .class-variable{color:#369}
-.CodeRay .decorator{color:#b0b}
-.CodeRay .definition{color:#099}
-.CodeRay .delimiter{color:#000}
-.CodeRay .doc{color:#970}
-.CodeRay .doctype{color:#34b}
-.CodeRay .doc-string{color:#d42}
-.CodeRay .escape{color:#666}
-.CodeRay .entity{color:#800}
-.CodeRay .error{color:#808}
-.CodeRay .exception{color:inherit}
-.CodeRay .filename{color:#099}
-.CodeRay .function{color:#900;font-weight:bold}
-.CodeRay .global-variable{color:#008080}
-.CodeRay .hex{color:#058}
-.CodeRay .integer,.CodeRay .float{color:#099}
-.CodeRay .include{color:#555}
-.CodeRay .inline{color:#00}
-.CodeRay .inline .inline{background:#ccc}
-.CodeRay .inline .inline .inline{background:#bbb}
-.CodeRay .inline .inline-delimiter{color:#d14}
-.CodeRay .inline-delimiter{color:#d14}
-.CodeRay .important{color:#555;font-weight:bold}
-.CodeRay .interpreted{color:#b2b}
-.CodeRay .instance-variable{color:#008080}
-.CodeRay .label{color:#970}
-.CodeRay .local-variable{color:#963}
-.CodeRay .octal{color:#40e}
-.CodeRay .predefined{color:#369}
-.CodeRay .preprocessor{color:#579}
-.CodeRay .pseudo-class{color:#555}
-.CodeRay .directive{font-weight:bold}
-.CodeRay .type{font-weight:bold}
-.CodeRay .predefined-type{color:inherit}
-.CodeRay .reserved,.CodeRay .keyword {color:#000;font-weight:bold}
-.CodeRay .key{color:#808}
-.CodeRay .key .delimiter{color:#606}
-.CodeRay .key .char{color:#80f}
-.CodeRay .value{color:#088}
-.CodeRay .regexp .delimiter{color:#808}
-.CodeRay .regexp .content{color:#808}
-.CodeRay .regexp .modifier{color:#808}
-.CodeRay .regexp .char{color:#d14}
-.CodeRay .regexp .function{color:#404;font-weight:bold}
-.CodeRay .string{color:#d20}
-.CodeRay .string .string .string{background:#ffd0d0}
-.CodeRay .string .content{color:#d14}
-.CodeRay .string .char{color:#d14}
-.CodeRay .string .delimiter{color:#d14}
-.CodeRay .shell{color:#d14}
-.CodeRay .shell .delimiter{color:#d14}
-.CodeRay .symbol{color:#990073}
-.CodeRay .symbol .content{color:#a60}
-.CodeRay .symbol .delimiter{color:#630}
-.CodeRay .tag{color:#008080}
-.CodeRay .tag-special{color:#d70}
-.CodeRay .variable{color:#036}
-.CodeRay .insert{background:#afa}
-.CodeRay .delete{background:#faa}
-.CodeRay .change{color:#aaf;background:#007}
-.CodeRay .head{color:#f8f;background:#505}
-.CodeRay .insert .insert{color:#080}
-.CodeRay .delete .delete{color:#800}
-.CodeRay .change .change{color:#66f}
-.CodeRay .head .head{color:#f4f}
-</style>
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/8.4/styles/github.min.css">
+<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/8.4/highlight.min.js"></script>
+<script>hljs.initHighlightingOnLoad()</script>
 </head>
 <body class="book toc2 toc-right">
 <div id="header">
@@ -622,8 +534,8 @@ New contributors are always welcome!
 </div>
 <h2 id="preface" class="discrete">Preface</h2>
 <div class="paragraph">
-<p>This guide provides comprehensive reference to Apache Syncope services for identity management, provisioning, and
-compliance.</p>
+<p>This reference guide covers Apache Syncope services for identity management,
+provisioning, and compliance.</p>
 </div>
 </div>
 </div>

Modified: syncope/site/2.0.0-SNAPSHOT/docs/reference-guide.pdf
URL: http://svn.apache.org/viewvc/syncope/site/2.0.0-SNAPSHOT/docs/reference-guide.pdf?rev=1708733&r1=1708732&r2=1708733&view=diff
==============================================================================
Binary files - no diff available.