Fix links in documentation.

Some method links in connection.rst still don't light up in scaladoc
(but at least the pages are now correct). They are probably wrong but
guessing the right ones is a nightmare. Scaladoc needs to add a way to
get proper links out of the generated pages to make this usable.
Update documentation for Lifted Embedding

- Better explanation for lifting
- New "Compiled Queries" feature
- MappedTo for automatic mapping of column types
- Fix links to API docs
- Fix overflow scrolling in new docs theme
Add migration guide 1.0 -> 2.0
Improved Lifted Embedding documentation.

- Use matching examples for plain and Rep types
- Show typical SQL statements
- Remove "soft insert" code snippet and paragraph
- Some small fixes
Refactoring of the user manual.

- Lifted Embedding chapter split up into Schemas, Queries and
  User-Defined Features.
- Overview of the query APIs in the Introduction chapter.
- Move Slick Extensions chapter further up, Direct Embedding
  and Slick Testkit down to the bottom.
- Clearly mark Direct Embedding as experimental.
- Put the Migration Guide near the top.
Introduction updates

* Add equivelent SQL to the first example
* Add link to Activator template in "What is Slick?"
* Change the features to match the home page
* Add code examples for the features
* Remove the quick overview since there is now a link to the Hello Slick template and we should rely on the Getting Started section to cover that content
Getting Started improvements

* Add Activator templates as the default path
* Replace the dependencies section with info on how to add Slick to an existing app
* Remove reference to example code (Note: We could possibly add references to the code in the Activator template but I'm not sure yet how that would work best.)
manual SQL to plain SQL
Compatibility with Slick extensions
- disabled tests, which use produce {fn …} calls which didn’t work for me in DB2
- disabled index reverse engineering in case of exception (Oracle requires extra permissions for indices, which may not always be available)
- allowed overriding dbPath from databases.properties for supporting remote test dbs (e.g. run tests on mac, connecting to dbs in windows vm)
Merge pull request #547 from slick/tmp/doc-improvements-rc1

Some doc improvements for RC1
Merge pull request #584 from slick/tmp/slick-extensions-compat

Compatibility with Slick extensions
Finish RC1, fix some docs, add codegen docs
Merge pull request #587 from slick/tmp/more-rc1-docs

Finish RC1, fix some docs, add codegen docs
Skip indices on postgres when referring to oid for now
Bump some docs versions to 2.0.0-RC1
Fixed typo in extensions.rst

Removed repeated word package
Merge pull request #588 from VlachJosef/patch-1

Fixed typo in extensions.rst
Merge remote-tracking branch 'refs/remotes/origin/pr/580'

Conflicts:
	src/sphinx/introduction.rst
add slf4j and slick examples
Merge remote-tracking branch 'refs/remotes/origin/pr/579'

Conflicts:
	src/sphinx/gettingstarted.rst