syncope-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cohei...@apache.org
Subject syncope git commit: More docs review
Date Fri, 26 Aug 2016 09:20:44 GMT
Repository: syncope
Updated Branches:
  refs/heads/master 92e8ecc48 -> e8c939772


More docs review


Project: http://git-wip-us.apache.org/repos/asf/syncope/repo
Commit: http://git-wip-us.apache.org/repos/asf/syncope/commit/e8c93977
Tree: http://git-wip-us.apache.org/repos/asf/syncope/tree/e8c93977
Diff: http://git-wip-us.apache.org/repos/asf/syncope/diff/e8c93977

Branch: refs/heads/master
Commit: e8c93977299c714b3c4059ddd0db8df0730ba4f6
Parents: 92e8ecc
Author: Colm O hEigeartaigh <coheigea@apache.org>
Authored: Fri Aug 26 10:20:30 2016 +0100
Committer: Colm O hEigeartaigh <coheigea@apache.org>
Committed: Fri Aug 26 10:20:30 2016 +0100

----------------------------------------------------------------------
 .../asciidoc/reference-guide/concepts/audit.adoc    |  4 ++--
 .../asciidoc/reference-guide/concepts/domains.adoc  |  2 +-
 .../reference-guide/concepts/extensions.adoc        | 10 +++++-----
 .../asciidoc/reference-guide/concepts/reports.adoc  | 16 ++++++++--------
 .../asciidoc/reference-guide/concepts/tasks.adoc    | 16 ++++++++--------
 .../adminconsole/adminconsole.adoc                  |  2 +-
 .../adminconsole/approval.adoc                      |  2 +-
 .../adminconsole/configuration.adoc                 |  8 ++++----
 .../adminconsole/dashboard.adoc                     |  2 +-
 .../adminconsole/realms.adoc                        |  2 +-
 .../adminconsole/topology.adoc                      |  4 ++--
 .../workingwithapachesyncope/cli/notification.adoc  |  4 ++--
 .../workingwithapachesyncope/cli/question.adoc      |  4 ++--
 .../workingwithapachesyncope/cli/resource.adoc      |  2 +-
 .../workingwithapachesyncope/cli/role.adoc          |  2 +-
 .../workingwithapachesyncope/cli/task.adoc          |  2 +-
 .../workingwithapachesyncope/cli/user.adoc          | 12 ++++++------
 .../workingwithapachesyncope.adoc                   |  4 ++--
 18 files changed, 49 insertions(+), 49 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/syncope/blob/e8c93977/src/main/asciidoc/reference-guide/concepts/audit.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/concepts/audit.adoc b/src/main/asciidoc/reference-guide/concepts/audit.adoc
index 5ae007a..476fdfd 100644
--- a/src/main/asciidoc/reference-guide/concepts/audit.adoc
+++ b/src/main/asciidoc/reference-guide/concepts/audit.adoc
@@ -30,5 +30,5 @@ An example of how audit entries can be extracted for reporting is shown
by the <
 
 ==== Audit Events
 
-What described for <<notification-events,notification events>> is also valid
for audit events, examples included -
-except for admin console <<console-configuration-audit,tooling>>, which is naturally
distinct.
+The information provided for <<notification-events,notification events>> is also
valid for audit events, including examples -
+except for the admin console <<console-configuration-audit,tooling>>, which is
naturally distinct.

http://git-wip-us.apache.org/repos/asf/syncope/blob/e8c93977/src/main/asciidoc/reference-guide/concepts/domains.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/concepts/domains.adoc b/src/main/asciidoc/reference-guide/concepts/domains.adoc
index cab6ef0..9ffdbd3 100644
--- a/src/main/asciidoc/reference-guide/concepts/domains.adoc
+++ b/src/main/asciidoc/reference-guide/concepts/domains.adoc
@@ -31,6 +31,6 @@ image::domains.png[title="Domains",alt="Domains"]
 
 [TIP]
 ====
-Each domain's persistence unit can be configured to work with one of <<persistence,supported
DBMSes>>: `Master` can be
+Each domain's persistence unit can be configured to work with one of the <<persistence,supported
DBMSes>>: `Master` can be
 on MySQL, `Domain1` on PostgreSQL, `DomainN` on Oracle and so on.
 ====

http://git-wip-us.apache.org/repos/asf/syncope/blob/e8c93977/src/main/asciidoc/reference-guide/concepts/extensions.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/concepts/extensions.adoc b/src/main/asciidoc/reference-guide/concepts/extensions.adoc
index 62b545e..360395e 100644
--- a/src/main/asciidoc/reference-guide/concepts/extensions.adoc
+++ b/src/main/asciidoc/reference-guide/concepts/extensions.adoc
@@ -18,8 +18,8 @@
 //
 === Extensions
 
-Extensions allow to optionally enrich the _vanilla_ Apache Syncope with useful features,
without the need of bloating
-every single deployment with non-needed libraries and configurations.
+The _vanilla_ Apache Syncope deployment can be optional enriched with useful features via
an Extension, instead of bloating
+every single deployment with unneeded libraries and configurations.
 
 With reference to <<architecture,architecture>>, an extension might add a <<rest>>
endpoint, manage the
 <<persistence,persistence>> of additional entities, extend the <<security,security>>
mechanisms, tweak the
@@ -31,7 +31,7 @@ Extensions are available from different sources:
 . as Maven artifacts published from the Apache Syncope codebase, part of the official releases
- this is the case of the
 ones detailed below;
 . as Maven artifacts published by third parties;
-. as part of a given deployment sources, as explained <<customization-extensions, in
the following>>.
+. as part of a given deployment source code, as explained <<customization-extensions,
in the following>>.
 
 ==== Apache Camel Provisioning Engine
 
@@ -61,7 +61,7 @@ endif::[]
 
 [TIP]
 ====
-This extension is adding features to all components and layers available and can be taken
as reference when creating
+This extension adds features to all components and layers that are available, and can be
taken as reference when creating
 <<customization-extensions,new extensions>>.
 ====
 
@@ -81,7 +81,7 @@ where `protocol`, `host` and `port` reflect your Java EE container installation.
 [NOTE]
 .Extension Sources
 ====
-The sources of this extension are available from the Apache Syncope
+The source code of this extension is available from the Apache Syncope
 ifeval::["{snapshotOrRelease}" == "release"]
 https://github.com/apache/syncope/tree/syncope-{docVersion}/ext/swagger-ui[source tree^]
 endif::[]

http://git-wip-us.apache.org/repos/asf/syncope/blob/e8c93977/src/main/asciidoc/reference-guide/concepts/reports.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/concepts/reports.adoc b/src/main/asciidoc/reference-guide/concepts/reports.adoc
index 8125f63..8dc3346 100644
--- a/src/main/asciidoc/reference-guide/concepts/reports.adoc
+++ b/src/main/asciidoc/reference-guide/concepts/reports.adoc
@@ -25,7 +25,7 @@ A report is essentially defined by a <<report-templates,template>>
and a sequenc
 the latter is responsible for extracting the required information and the former defines
how execution results will be
 presented, in the various available formats.
 
-Reports can be execute upon request or scheduled: executions result can be downloaded as:
+Reports can be executed upon request or scheduled: execution results can be downloaded as:
 
 * XML
 * HTML
@@ -45,7 +45,7 @@ will be then made available as PDF and RTF
 
 [NOTE]
 ====
-Report templates can be easily managed either via <<console-reports,admin console>>
or <<eclipse-ide-plugin>>.
+Report templates can be easily managed either via the <<console-reports,admin console>>
or the <<eclipse-ide-plugin>>.
 ====
 
 ==== Reportlets
@@ -70,10 +70,10 @@ ifeval::["{snapshotOrRelease}" == "snapshot"]
 https://github.com/apache/syncope/blob/master/common/lib/src/main/java/org/apache/syncope/common/lib/report/AbstractReportletConf.java[AbstractReportletConf^]
 endif::[]
 and embedding the configuration options that can be tuned when incorporating a given reportlet
into a report; when
-properly annotated, such options are manageable via <<console-reports,admin console>>
+properly annotated, such options are manageable via the <<console-reports,admin console>>
 
-Some reportlets are available by default (and briefly presented below) either for direct
usage and for acting as
-reference when building new reportlets for specific Apache Syncope deployments.
+Some reportlets are available by default (and briefly presented below) either for direct
usage or for acting as
+a reference when building new reportlets for specific Apache Syncope deployments.
 
 ===== Static Reportlet
 
@@ -91,7 +91,7 @@ endif::[]
 ifeval::["{snapshotOrRelease}" == "snapshot"]
 https://github.com/apache/syncope/blob/master/common/lib/src/main/java/org/apache/syncope/common/lib/report/StaticReportletConf.java[StaticReportletConf^],
 endif::[]
-it is essentially an handy way to inject static values (of various types) into a report.
+it is essentially a handy way to inject static values (of various types) into a report.
 
 ===== User and Group Reportles
 Defined by
@@ -108,7 +108,7 @@ endif::[]
 ifeval::["{snapshotOrRelease}" == "snapshot"]
 https://github.com/apache/syncope/blob/master/common/lib/src/main/java/org/apache/syncope/common/lib/report/UserReportletConf.java[UserReportletConf^],
 endif::[]
-it can be used for reporting various information about Users available in the internal storage,
their attributes,
+it can be used to report various information about Users available in the internal storage,
their attributes,
 memberships and relationships, external resources and so on.
 
 A similar reportlet is also available for Groups, defined by
@@ -147,7 +147,7 @@ e.g. whether such entities are available on all Identity Stores matching
the ass
 <<external-resources,external resources>> and, if so, whether the <<mapping,mapped>>
attributes feature the expected
 values.
 
-An instance of reconciliation reportlet is run by default from admin console's <<dashboard,dashboard>>,
and results
+An instance of reconciliation reportlet is run by default from the admin console's <<dashboard,dashboard>>,
and results
 are available as a widget.
 
 ===== Audit Reportlet

http://git-wip-us.apache.org/repos/asf/syncope/blob/e8c93977/src/main/asciidoc/reference-guide/concepts/tasks.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/concepts/tasks.adoc b/src/main/asciidoc/reference-guide/concepts/tasks.adoc
index 2c50840..5218b97 100644
--- a/src/main/asciidoc/reference-guide/concepts/tasks.adoc
+++ b/src/main/asciidoc/reference-guide/concepts/tasks.adoc
@@ -18,7 +18,7 @@
 //
 === Tasks
 
-Tasks control the effective operations ongoing in the <<core>>.
+Tasks control the effective operations that are ongoing in the <<core>>.
 
 Whilst tasks define what and how to perform, they are supposed to be run by some entity (depending
on the actual task
 type, see below for details); their execution result can be saved for later examination.
@@ -26,7 +26,7 @@ type, see below for details); their execution result can be saved for later
exam
 [[tasks-propagation]]
 ==== Propagation
 
-A propagation task encapsulates all the information required - according to the defined <<mapping,mapping>>
- to create,
+A propagation task encapsulates all the information that is required - according to the defined
<<mapping,mapping>> - to create,
 update or delete a given User, Group or Any Object, to / from a certain Identity Store:
 
 * operation - `CREATE`, `UPDATE` or `DELETE`
@@ -85,7 +85,7 @@ When defining a pull task, the following information must be provided:
 
 [NOTE]
 ====
-Pull tasks are executed, either upon request or because scheduled, via the
+Pull tasks are executed, either upon request or due to a schedule, via the
 ifeval::["{snapshotOrRelease}" == "release"]
 https://github.com/apache/syncope/blob/syncope-{docVersion}/core/provisioning-java/src/main/java/org/apache/syncope/core/provisioning/java/pushpull/PullJobDelegate.java[PullJobDelegate^]
 endif::[]
@@ -116,7 +116,7 @@ When defining a push task, the following information must be provided:
 
 [NOTE]
 ====
-Push tasks are executed, either upon request or because scheduled, via the
+Push tasks are executed, either upon request or due to a schedule, via the
 ifeval::["{snapshotOrRelease}" == "release"]
 https://github.com/apache/syncope/blob/syncope-{docVersion}/core/provisioning-java/src/main/java/org/apache/syncope/core/provisioning/java/pushpull/PushJobDelegate.java[PushJobDelegate^]
 endif::[]
@@ -131,7 +131,7 @@ the execution details - depending on the trace level set on the related
 [[tasks-notification]]
 ==== Notification
 
-A notification tasks encapsulates all the information required for sending out a notification
e-mail, according to the
+A notification task encapsulates all the information that is required to send out a notification
e-mail, according to the
 specification provided in a given <<notifications,notification>>:
 
 * entity - reference to the internal identity - User, Group or Any Object - the notification
task refers to
@@ -163,7 +163,7 @@ and are permanently saved - for later re-execution or for examining the
executio
 [[tasks-custom]]
 ==== Custom
 
-Custom tasks allow to inject logic into the <<core>>, available for execution
and scheduling.
+Custom tasks allow for the injection of logic into the <<core>> in the area of
execution and scheduling.
 
 When defining a custom task, the following information must be provided:
 
@@ -184,8 +184,8 @@ providing the custom logic to execute
 Custom tasks are ideal for implementing periodic checks or clean-up operations, possibly
in coordination with other
 components; some examples:
 
-* move users from "peding delete" to "deleted" status 15 days after they reached the "pending
delete" status (requires
+* move users from "pending delete" to "deleted" status 15 days after they reached the "pending
delete" status (requires
 interaction with <<activiti-user-workflow-adapter>>)
 * send out notification e-mails to users whose password is about to expire on an Identity
Store
-* disable all users not logging in into the system for the past 6 months
+* disable all users not logging into the system for the past 6 months
 ====

http://git-wip-us.apache.org/repos/asf/syncope/blob/e8c93977/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/adminconsole.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/adminconsole.adoc
b/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/adminconsole.adoc
index 3be76c6..c9e124f 100644
--- a/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/adminconsole.adoc
+++ b/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/adminconsole.adoc
@@ -25,7 +25,7 @@ protocol://host:port/syncope-console/
 
 where `protocol`, `host` and `port` reflect your Java EE container installation.
 
-You should be greeted with the following web page.
+You should be greeted by the following web page.
 
 image::consoleLogin.png[console-login]
 

http://git-wip-us.apache.org/repos/asf/syncope/blob/e8c93977/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/approval.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/approval.adoc
b/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/approval.adoc
index 1d30904..d6d6b88 100644
--- a/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/approval.adoc
+++ b/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/approval.adoc
@@ -20,7 +20,7 @@
 [[console-approval]]
 ===== Approval
 
-The images below refers to the self-registration approval <<sample-selfreg-approval,sample>>
and to the typical approval
+The images below refer to the self-registration approval <<sample-selfreg-approval,sample>>
and to the typical approval
 flow as explained <<approval,above>>.
 
 image::approval1.png[title="Approval notification",alt="Approval notification"]

http://git-wip-us.apache.org/repos/asf/syncope/blob/e8c93977/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/configuration.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/configuration.adoc
b/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/configuration.adoc
index 1c4c6df..8bcf9c3 100644
--- a/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/configuration.adoc
+++ b/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/configuration.adoc
@@ -24,13 +24,13 @@ organization.
 [[console-configuration-audit]]
 Audit::
 
-Allows to configure the <<audit,auditing>> features.
+Controls the configuration of the <<audit,auditing>> features.
 
 [[console-configuration-logs]]
 Logs::
 
 The logging levels available can be dynamically adjusted; for example, the admin can set
it
-to display only the errors of `io.swagger`, in which case the warnings and information logs
will not be reported.
+to display only the errors of `io.swagger`, in which case the warning and information logs
will not be reported.
 
 [[console-configuration-notifications]]
 Notifications::
@@ -41,10 +41,10 @@ This page also allows the administators to create and edit <<notification-templa
 [[console-configuration-parameters]]
 Parameters::
 
-Presents the administrators with the list of defined <<configuration-parameters,configurtion
parameters>> used in the
+Presents the administrators with the list of defined <<configuration-parameters,configuration
parameters>> used in the
 given deployment such as `token.expireTime` and `password.cipher.algorithm`.
 These can be edited to further customize the deployment. +
-New parameters can also be added, for usage with custom code. 
+New parameters can also be added, for use with custom code. 
 
 [[console-configuration-policies]]
 Policies::

http://git-wip-us.apache.org/repos/asf/syncope/blob/e8c93977/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/dashboard.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/dashboard.adoc
b/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/dashboard.adoc
index cbc5f63..ce8c857 100644
--- a/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/dashboard.adoc
+++ b/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/dashboard.adoc
@@ -19,6 +19,6 @@
 ===== Dashboard
 
 The dashboard provides an overall view of the current state of the Apache Syncope deployment.
It
-consists of various widgets and tabs that show the different metrics and details of each
component available.
+consists of various widgets and tabs that show the different metrics and details of each
component that is available.
 
 image::consoleDashboard.png[console-dashboard]

http://git-wip-us.apache.org/repos/asf/syncope/blob/e8c93977/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/realms.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/realms.adoc
b/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/realms.adoc
index 701f021..00c0b42 100644
--- a/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/realms.adoc
+++ b/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/realms.adoc
@@ -20,6 +20,6 @@
 ===== Realms
 
 The realms page provides the designated administators with the power to manage <<realms>>
as well as
-<<users-groups-and-any-objects>>, for all <<anytype, Any Types>>
defined.
+<<users-groups-and-any-objects>>, for all <<anytype, Any Types>>
that are defined.
 
 image::realmsUser.png[console-realms-user]

http://git-wip-us.apache.org/repos/asf/syncope/blob/e8c93977/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/topology.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/topology.adoc
b/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/topology.adoc
index bd281f0..7d0f5fb 100644
--- a/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/topology.adoc
+++ b/src/main/asciidoc/reference-guide/workingwithapachesyncope/adminconsole/topology.adoc
@@ -18,8 +18,8 @@
 //
 ===== Topology
 
-The topology page provides a mapped view of the available <<connector-instance-details,connectors>>
and
-<<external-resource-details,external resources>> available and configured in
the given deployment. +
+The topology page provides a mapped view of the <<connector-instance-details,connectors>>
and
+<<external-resource-details,external resources>> that are available and configured
in the given deployment. +
 Different actions are available when clicking on the various nodes.
 
 image::consoleTopology.png[console-topology]

http://git-wip-us.apache.org/repos/asf/syncope/blob/e8c93977/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/notification.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/notification.adoc
b/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/notification.adoc
index a79073a..5b3744b 100644
--- a/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/notification.adoc
+++ b/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/notification.adoc
@@ -37,8 +37,8 @@ Usage: notification [options]
 ====== Options
 
 --list::
-Running the command with this option you will see the list of notificaitons with their configuration.
+Running the command with this option you will see the list of notifications with their configuration.
 --read::
 The option to read all the information of the specified notifications.
 --delete::
-The option to delete a specified notification.
\ No newline at end of file
+The option to delete a specified notification.

http://git-wip-us.apache.org/repos/asf/syncope/blob/e8c93977/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/question.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/question.adoc
b/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/question.adoc
index 624f33d..3298230 100644
--- a/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/question.adoc
+++ b/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/question.adoc
@@ -17,7 +17,7 @@
 // under the License.
 //
 ===== Question command
-This command works with security questions for usage with <<password-reset,password
reset>>.
+This command works with security questions for use with <<password-reset,password reset>>.
 
 [discrete]
 ====== Help message
@@ -41,4 +41,4 @@ Running the command with this option you will see the list of questions
with the
 --read::
 The option to read all the information of specified questions.
 --delete::
-The option to delete a specified question.
\ No newline at end of file
+The option to delete a specified question.

http://git-wip-us.apache.org/repos/asf/syncope/blob/e8c93977/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/resource.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/resource.adoc
b/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/resource.adoc
index c8433b0..1db624c 100644
--- a/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/resource.adoc
+++ b/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/resource.adoc
@@ -38,7 +38,7 @@ Usage: resource [options]
 ====== Options
 
 --details::
-This option shows a table with amount of available resources.
+This option shows a table with the amount of available resources.
 --list::
 Running the command with this option you will see the list of resources.
 --read::

http://git-wip-us.apache.org/repos/asf/syncope/blob/e8c93977/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/role.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/role.adoc b/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/role.adoc
index 7214711..471c388 100644
--- a/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/role.adoc
+++ b/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/role.adoc
@@ -40,7 +40,7 @@ Usage: role [options]
 --details::
 This option shows a table with some details about the roles.
 --list::
-Running the command with this option you will see the list of roles with the realm where
they are configured and their entitlments.
+Running the command with this option you will see the list of roles with the realm where
they are configured and their entitlements.
 --read::
 The option to read all the information of specified roles.
 --delete::

http://git-wip-us.apache.org/repos/asf/syncope/blob/e8c93977/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/task.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/task.adoc b/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/task.adoc
index d4ddc94..0f12ad8 100644
--- a/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/task.adoc
+++ b/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/task.adoc
@@ -55,7 +55,7 @@ Running the command with this option you will see the list of selected tasks
typ
 --list-scheduled-jobs::
 Running the command with this option you will see the list of the actual scheduled jobs.
 --list-running-jobs::
-Running the command with this option you will see the list of the actual runnig jobs.
+Running the command with this option you will see the list of the actual running jobs.
 --read::
 The option to read all the information of a task.
 --read-execution::

http://git-wip-us.apache.org/repos/asf/syncope/blob/e8c93977/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/user.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/user.adoc b/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/user.adoc
index 542c5b9..6aeffff 100644
--- a/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/user.adoc
+++ b/src/main/asciidoc/reference-guide/workingwithapachesyncope/cli/user.adoc
@@ -55,9 +55,9 @@ Usage: user [options]
 
 --details::
 This option shows a table with some details about the Users.
--- List option::
+--list::
 Running the command with this option you will see the list of all Users in the environment.
However, the system will 
-ask you a confirmation before execution, because as you can imagine this operation might
produce very large output.
+ask you a confirmation before execution, because as you can imagine this operation might
produce a very large output.
 --get-user-key::
 The option to get the user key starting from a username.
 --get-username::
@@ -72,9 +72,9 @@ The option to search a list of Users with a common attribute.
 The option to search a list of Users with a specified role.
 --search-by-resource::
 The option to search a list of Users with a specified resource.
---delete
+--delete::
 The option to delete a specified user.
---delete-by-attribute
+--delete-by-attribute::
 The option to delete the Users with a common attribute.
---delete-all
-The option to delete all Users of the realm passed as input.
\ No newline at end of file
+--delete-all::
+The option to delete all Users of the realm passed as input.

http://git-wip-us.apache.org/repos/asf/syncope/blob/e8c93977/src/main/asciidoc/reference-guide/workingwithapachesyncope/workingwithapachesyncope.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/workingwithapachesyncope/workingwithapachesyncope.adoc
b/src/main/asciidoc/reference-guide/workingwithapachesyncope/workingwithapachesyncope.adoc
index 29b817a..8920391 100644
--- a/src/main/asciidoc/reference-guide/workingwithapachesyncope/workingwithapachesyncope.adoc
+++ b/src/main/asciidoc/reference-guide/workingwithapachesyncope/workingwithapachesyncope.adoc
@@ -18,7 +18,7 @@
 //
 == Working with Apache Syncope
 
-Before moving forward, please ensure to have access to an Apache Syncope running deployment.
+Before proceeding, please ensure that you have access to a running Apache Syncope deployment.
 You can take a look at the
 ifeval::["{backend}" == "html5"]
 http://syncope.apache.org/docs/getting-started.html[Apache Syncope Getting Started Guide]
@@ -26,7 +26,7 @@ endif::[]
 ifeval::["{backend}" == "pdf"]
 http://syncope.apache.org/docs/getting-started.pdf[Apache Syncope Getting Started Guide]
 endif::[]
-to check system requirements and choose among the various options for obtaining Apache Syncope.
+to check system requirements and to choose among the various options for obtaining Apache
Syncope.
 
 include::adminconsole/adminconsole.adoc[]
 


Mime
View raw message