Merge lp:~thomas-voss/location-service/iterate-on-docs into lp:location-service

[Thomas Voß]

Adjust formatting and rename to locationd in docs.

Adjust formatting and rename to locationd in docs.

[Simon Fels (morphis)]

LGTM

review: Approve

=== modified file 'doc/cli.md'
--- doc/cli.md	2016-12-09 12:36:42 +0000
+++ doc/cli.md	2017-01-30 09:10:10 +0000
@@ -1,14 +1,14 @@
 # CLI
 
-The location service offers a command-line interface for controlling
+locationd offers a command-line interface for controlling
 and monitoring the service. The following commands are available:
 
- - list: Lists all provider implementations known to the service.
- - monitor: Connects to a location service instance, monitoring its activity.
- - provider: Executes a known provider implementation in an out-of-process sandbox.
- - run: Executes the service.
- - status: Queries the status of a service instance.
- - test: Executes runtime tests against known provider implementations.
+ - `list`: Lists all provider implementations known to the service.
+ - `monitor`: Connects to a locationd instance, monitoring its activity.
+ - `provider`: Executes a known provider implementation in an out-of-process sandbox.
+ - `run`: Executes the service.
+ - `status`: Queries the status of a service instance.
+ - `test`: Executes runtime tests against known provider implementations.
 
 For all of the commands, an exit status of 0 indicates success. An exit status of 1 indicates
 an error. Normal output goes to stdout, while all errors/warnings are output to stderr.

=== modified file 'doc/intro.md'
--- doc/intro.md	2016-09-22 10:46:17 +0000
+++ doc/intro.md	2017-01-30 09:10:10 +0000
@@ -1,6 +1,6 @@
 # Introduction
 
-Ubuntu's location service is a central hub for multiplexing access to
+locationd is a central hub for multiplexing access to
 positioning subsystems available via hard- and software. It provides a
 client API offering positioning capabilities to applications and other
 system components, abstracting away the details of individual
@@ -11,25 +11,25 @@
 To make the remainder of this documentation as easily understandable
 as possible, we start over with introducing some vocabulary:
 
- - Engine: Responsible for handling input from multiple positioning
+ - `Engine`: Responsible for handling input from multiple positioning
    subsystems and maintaining the state of the overall system. Think
    about it like the heart of the system.
 
- - Provider: A positioning subsystem that feeds into the positioning
+ - `Provider`: A positioning subsystem that feeds into the positioning
    engine. Common examples are a GPS provider or a network-based
    positioning provider.
 
- - Service: The point of entry for applications and services that would
+ - `Service`: The point of entry for applications and services that would
    like to receive position data.
 
- - Session: In order to receive position information, every application
+ - `Session`: In order to receive position information, every application
    or service has to create a session with the location Service.
    Session creation is subject to security mediation and contextual
    prompting.
 
-- Update: An update is a timestamped entity to a certain type of data.
+ - `Update`: An update is a timestamped entity to a certain type of data.
 
-- [WGS84](http://en.wikipedia.org/wiki/World_Geodetic_System): The coordinate system that is used throughout the entire location subsystem.
+ - [WGS84](http://en.wikipedia.org/wiki/World_Geodetic_System): The coordinate system that is used throughout the entire location subsystem.
 
 ## Architectural Overview
 
@@ -60,14 +60,14 @@
 ## Privacy & Access Control
 
 Location information is highly privacy relevant. For this reason, the
-location service is deeply integrated with AppArmor and Ubuntu's
+locationd is deeply integrated with AppArmor and Ubuntu's
 overall trust infrastructure. Every incoming session request is
 validated and if in doubt, the user is asked to explicitly grant trust
 to the application requesting access to positioning
 information. Please see [@ref com::ubuntu::location::service::PermissionManager]
 for further details.
 
-In addition, the location service allows for selectively adjusting the
+In addition, the locationd allows for selectively adjusting the
 accuracy and reporting setup of the location Engine to provide further
 fine-grained control over the exposed data to user. Within this setup,
 a user is able to entirely disable all positioning.