docs: added 4.13 release note about potential encoding problems

docs/release-notes/release-notes-4.13.0.rst

@@ -1,133 +1,137 b''
 |RCE| 4.13.0 |RNS|
 ------------------
 
 Release Date
 ^^^^^^^^^^^^
 
 - 2018-09-05
 
 
 New Features
 ^^^^^^^^^^^^
 
 - Branch permissions: new set of permissions were added to control branch modification.
   There are 4 basic permissions that can be set for branch names/branch patterns:
   * no-access (any modification for given branch is forbidden)
   * web-merge (modify branch by web based PR merge)
   * push (only non-forced modification on branch are allowed)
   * forced push (all modification to branch are allowed)
   Available in EE edition only.
 - Unified search and repo-switcher: a new persistent search box is now present allowing
   to search for repositories, repository groups, commits (using full text search),
   users, user-groups. Replaces redundant quick-filters/repo switcher.
 - Default Reviewers: added possibility to match against regex based pattern as
   alternative syntax to glob which didn't handle all the cases.
 - Built-in Error tracker: added new exception tracking capability. All errors are now
   tracked and stored. This allows instance admins to see potential problems without
   access to the machine and logs.
 - User Groups: each user group which users have access to expose public profile link.
   It's possible to view the members of a group before attaching it to any resource.
 - New caching framework: existing Beaker cache was completely replaced by dogpile.cache
   library. This new cache framework in addition to solving multiple
   performance/reliability problems of Beaker is used to cache permissions tree.
   This gives huge performance boosts for very large and complex permission trees.
 - Pull Requests: description field is now allowed to use a RST/Markdown syntax.
 - SVN: added support for SVN 1.10 release line.
 
 
 General
 ^^^^^^^
 
 - Google: updated google auth plugin with latest API changes.
 - Frontend: Switched to Polymer 2.0.
 - Events: added a default timeout for operation calling the endpoint url, so
   they won't block forever.
 - SQLAlchemy: allow DB connection ping/refresh using dedicated flag from .ini file.
   `sqlalchemy.db1.ping_connection = true`
 - Pull Requests: added option to force-refresh merge workspace in case of problems.
   Adding GET param `?force_refresh=1` into PR page triggers the refresh.
 - Pull Requests: show more info about version of comment vs latest version.
 - Diffs: skip line numbers during copy from a diff view.
 - License: use simple cache to read license info.
   Due to the complex and expensive encryption, this reduces requests time by ~10ms.
 - Debug: add new custom logging to track unique requests across systems.
   Allows tracking single requests in very busy system by unique ID added into logging system.
 - Configuration: .ini files now can replace a special placeholders e.g "{ENV_NAME}"
   into a value from the ENVIRONMENT. Allows easier setup in Docker and similar.
 - Backend: don't support vcsserver.scm_app anymore, now it uses http even if scm_app
   is specified.
 - Repositories: re-order creation/fork forms for better UX and consistency.
 - UI: Add the number of inactive users in _admin/users and _admin/user_groups
 - UX: updated registration form to better indicate what is the process of binding a
   RhodeCode account with external one like Google.
 - API: pull-requests allow automatic title generation via API
 - VCSServer: errors: use a better interface to track exceptions and tracebacks.
 - VCSServer: caches: replaced beaker with dogpile cache.
 - GIT: use GIT_DISCOVERY_ACROSS_FILESYSTEM for better compatibility on NFS servers.
 - Dependencies: bumped mercurial to 4.6.2
 - Dependencies: bumped evolve to 8.0.1
 - Dependencies: bumped hgsubversion to 1.9.2
 - Dependencies: bumped git version to 2.16.4
 - Dependencies: bumped SVN to 1.10.2
 - Dependencies: added alternative pymysql drivers for mysql
 - NIX: updated to 18.03 nix packages, now shipped with python 2.7.15
   release and multiple other new libraries.
 
 
 Security
 ^^^^^^^^
 
 - Mercurial: general protocol security updates.
   * Fixes Mercurial's CVE for lack of permissions checking on mercurial batch commands.
   * Introduced more strict checks for permissions, now they default to push instead of pull.
   * Decypher batch commands and pick top-most permission to be required.
   * This follows changes in Mercurial CORE after 4.6.1 release.
 - Fixed bug in bleach sanitizer allowing certain custom payload to bypass it. Now
   we always fails if sanitizing fails. This could lead to stored XSS
 - Fixed stored XSS in binary file rendering.
 - Fixed stored XSS in repo forks datagrid.
 
 
 Performance
 ^^^^^^^^^^^
 
 - Permissions: Permission trees for users and now cached, after calculation.
   This reduces response time for some pages dramatically.
   In case of any permission changes caches are invalidated.
 - Core: new dogpile.cache based cache framework was introduced, which is faster than
   previously used Beaker.
 
 
 Fixes
 ^^^^^
 
 - Audit Logs: store properly IP for certain events.
 - External Auth: pass along came_from into the url so we get properly
   redirected back after logging using external auth provider.
 - Pull Requests: lock submit on pull request to prevent double submission on a fast click.
 - Pull Requests: fixed a case of unresolved comments attached to removed file in pull request.
   That prevented from closing it.
 - Pull Requests: use numeric repo id for creation of shadow repos. Fixes a problem
   when repository is renamed during PR lifetime.
 - API: fixed creation of a pull request with default reviewer rules.
 - Default Reviewers: fixed voting rule calculation on user group.
 - Pull Requests: in GIT use force fetch and update for target ref.
   This solves a case when in PR a target repository is force updated (by push force)
   and is out of sync.
 - VCSServer: detect early potential locale problem, and fallback to LC_ALL=C,
   instead of crashing vcsserver.
 - Pull Requests: use a safer way of destroying shadow repositories.
   Fixes some problems in NFS storage and big repositories
 
 
 Upgrade notes
 ^^^^^^^^^^^^^
 
 - The direct backend `vcsserver.scm_app` is not supported anymore. This backed was
   already deprecated some time ago. Now it will use `http` mode even if scm_app is
   specified. Please contact us in case you still use it, and not sure how to upgrade.
 - New dogpile cache settings are not ported to converted .ini. If users want to do
   adjustments please copy the settings over dogpile cache section from a newly
   generated rhodecode.template.ini file. This file is stored next to rhodecode.ini
 - SVN 1.10.2 was introduced in this release. Please make sure to update your
   mod_dav to the same version for best compatibility.
+- This release brings new Database drivers. We discovered that in some setups it is now
+  required to explicitly define a encoding charset in the database connection string.
+  If you're getting a permanent exception such as `"UnicodeDecodeError: 'utf8' codec can't decode byte 0xfc in position 15: invalid start byte"`
+  please follow a fix from here: https://community.rhodecode.com/t/unicodedecodeerror-utf8-codec-cant-decode-byte-0xfc-in-position-15-invalid-start-byte/246