Bring back Google Analytics with Privacy Policy

Author: povder

rdbc-doc/docs/index.md

@@ -16,7 +16,7 @@
 
 ## What is rdbc?
 
-rdbc is a SQL-level relational database connectivity API targeting Scala and 
+rdbc is a SQL-level relational database access API targeting Scala and 
 Java programming languages. The API is fully asynchronous and provides
 a possibility to leverage [Reactive Streams'](http://www.reactive-streams.org/)
 stream processing capabilities.
@@ -45,12 +45,12 @@ Following list outlines the goals of the API:
     and get results back. While it can be used directly it's also meant to 
     provide a foundation for higher-level APIs like functional or object
     relational mapping libraries.
-   
+    
 ## Non-goals
 
 Following list outlines the areas that the API is not meant to cover.
 
-1. **Provide a full type-safety.**
+1. **Will not provide a full type-safety.**
 
     rdbc works on a SQL level, meaning that requests made to the database
     are strings. There is no additional layer that would ensure type-safety

rdbc-doc/docs/javascripts/extra.js

@@ -0,0 +1,16 @@
+(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
+
+var gaID = 'UA-103140141-1';
+
+ga('create', gaID, 'auto');
+ga('set', 'anonymizeIp', true);
+ga('send', 'pageview');
+
+function gaOptout() {
+    var disableStr = 'ga-disable-' + gaID;
+    document.cookie = disableStr + '=true; domain=' + window.location.hostname + '; expires=Thu, 31 Dec 2099 23:59:59 UTC; path=/';
+    window[disableStr] = true;
+}

rdbc-doc/docs/privacy.md

@@ -0,0 +1,30 @@
+<!---
+ ! Copyright 2016-2017 rdbc contributors
+ !
+ ! Licensed under the Apache License, Version 2.0 (the "License");
+ ! you may not use this file except in compliance with the License.
+ ! You may obtain a copy of the License at
+ !
+ !     http://www.apache.org/licenses/LICENSE-2.0
+ !
+ ! Unless required by applicable law or agreed to in writing, software
+ ! distributed under the License is distributed on an "AS IS" BASIS,
+ ! WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ ! See the License for the specific language governing permissions and
+ ! limitations under the License. 
+ -->
+ 
+## Data collection
+
+This site uses Google Analytics to collect information. No personally identifiable
+information is collected. This site uses Google Analytics IP address anonymization feature.
+
+## Data processing
+
+The site owner uses the collected data to understand how many people visit
+the site pages and where they came from.
+
+## Opt-out from tracking
+
+Click <a onclick="gaOptout(); alert('Opted out')">here</a> to opt-out of the
+tracking. This will create a cookie to remember the opt-out for your browser.

rdbc-doc/docs/scala/statements.md

@@ -21,8 +21,8 @@ to a database for execution along with arguments, if any. There are two types
 of statements in rdbc: template statements and executable statements. Template
 statements can't be executed right away. To execute them you first need to bind argument
 for every parameter they declare. When filled with arguments, template statements
-create executable statements. Statements in rdbc are a representation database engine's
-[prepared statements](https://en.wikipedia.org/wiki/Prepared_statement).
+create executable statements. Statements in rdbc are a representation of database 
+engine's [prepared statements](https://en.wikipedia.org/wiki/Prepared_statement).
 
 ## Syntax
 
@@ -169,9 +169,9 @@ def findUsersStmt(name: String): ExecutableStatement = {
 ```
 
 !!! tip "SQL injection safety"
-    Important thing to understand is that when using `sql` interpolator you're still
-    safe from creating SQL injection vulnerability. Even though it may look like
-    that, parameter values are **not** passed in to the database as literals
+    The important thing to understand is that when using `sql` interpolator you're still
+    safe from SQL injection vulnerability. Even though it may look like
+    that, parameter values are **not** passed to the database as literals
     concatenated with the rest of the SQL.
 
 SQL parts created by `sql` interpolator can be concatenated in the same way you
@@ -460,8 +460,8 @@ Creating `Publisher` instances is out of scope of this manual, for details pleas
 refer to documentation of Reactive Streams compatible libraries that are built to
 facilitate this, like
 [Akka stream](http://doc.akka.io/docs/akka/current/scala/stream/index.html) or
-[Monix](https://monix.io/). Examples below use simple streams backed by in
-memory collections.
+[Monix](https://monix.io/). Examples below use simple streams backed by in-memory
+collections.
 
 
 Streaming named arguments with Akka:

rdbc-doc/mkdocs.yml

@@ -15,6 +15,7 @@ pages:
     - Java API user guide: java/java.md
     - Drivers: drivers.md
     - Examples: examples.md
+    - Privacy policy: privacy.md
 theme:
   name: material
   palette:
@@ -43,3 +44,6 @@ markdown_extensions:
 
 extra_css:
   - 'css/extra.css'
+
+extra_javascript:
+  - 'javascripts/extra.js'