diff --git a/CHANGELOG.md b/CHANGELOG.md
deleted file mode 100644
index 58a5e25486..0000000000
--- a/CHANGELOG.md
+++ /dev/null
@@ -1,325 +0,0 @@
-# Zanata change log summary
-
-## zanata-3.0.0
- * File upload
- * Move raw document storage to file system
- * Implement virus scanning using ClamAV (clamdscan)
- * Add descriptions on project type selectors
- * Allow adapter parameters to be set on source document upload
- * Editor improvements
- * Add attention key shortcut: Alt+X
- * Add attention shortcut to copy from source: Alt+X,G
- * TMX import/export
- * Allow users to export translations to TMX (from Project/Version pages)
- * Allow admins to export **all** project translations to TMX (from Projects page)
- * Allow admins to import and export TMX translation memories (from Admin pages)
- * Imported TMX shown in translation memory search results
- * Translation review/approval
- * Coordinators can assign reviewers for their languages
- * Project maintainers can require review for translations in their projects
- * Reviewers can approve or reject translations
- * Translators and reviewers can add comments to translations
- * New visual style for Zanata
- * Add Zanata dashboard
- * Recent translation/review activity
- * List of maintained projects
- * Upgrade platform to JBoss EAP 6.1
-
-## zanata-2.3.1
- * Bug fixes:
- * Prevent incorrect validation warnings with concurrent edits
- * Search result back to editor causes multiple code mirror focus
- * Support message bookmark
-
-
-## TODO fill in releases between 2.0.3 and 2.3.1
-
-## zanata-2.0.3
- * Bug fixes: https://bugzilla.redhat.com/buglist.cgi?j_top=OR&f1=cf_fixed_in&o1=substring&classification=Community&o2=substring&query_format=advanced&f2=cf_fixed_in&bug_status=VERIFIED&bug_status=RELEASE_PENDING&bug_status=POST&bug_status=CLOSED&v1=2.0.3&product=Zanata
- * Allow admin to add extra locales by typing in the BCP-47 locale code.
- * TM Merge reports what it did
- * Allow choice of editor page size
- * Support txt, dtd and open document format (REST & web interface)
- * Editor option to disable CodeMirror (to enable browser spell-check)
- * Detect loss of connection to server
- * Fix for problem creating users with Kerberos
- * Allow Project Maintainers to Delete a Source Document
-
-## zanata-2.0.2
- * Bug fixes for document search/navigation
-
-## zanata-2.0.1
- * Update jboss-el to avoid bad artifact in repository
-
-## zanata-2.0.0
- * UI redesign
- * Bug fixes: https://bugzilla.redhat.com/buglist.cgi?j_top=OR&f1=cf_fixed_in&o1=substring&classification=Community&o2=substring&query_format=advanced&f2=cf_fixed_in&bug_status=CLOSED&v1=1.8.0&v2=2.0.0&product=Zanata
- * Performance: async push service to avoid timeouts when pushing source/target
- * Performance: improve performance when loading large documents
- * Allow user to save work when concurrent edit occurs
- * Include last translator information in TM info box
- * Web analytics (Piwik integration)
- * Navigation breadcrumbs
- * Bugzilla link in UI
- * Get Stats about Translation Documents via REST
- * Remove blinking notification in editor
- * Configurable page size
- * Advanced glossary features
- * Open ID Authentication
- * Admin role assignment configuration for authentication types
- * Highlight tags in editor fields (CodeMirror for editor)
- * Translation editor rewrite
- * Project-level default Copy Trans options
- * Red bars for translations with validation warnings should stay in red when moving to the next row
- * Option to show word or message based statistics
- * Visible whitespace in editor
- * View history of translations for a text flow
-
-## zanata-1.7.3
- * Bug fixes: https://bugzilla.redhat.com/buglist.cgi?f1=cf_fixed_in&o1=substring&classification=Community&query_format=advanced&bug_status=CLOSED&v1=1.7.3&product=Zanata
-
-## zanata-1.7.2
- * Bug fixes: https://bugzilla.redhat.com/buglist.cgi?classification=Community&target_release=1.7.2&query_format=advanced&bug_status=CLOSED&product=Zanata
-
-## zanata-1.7.1
- * Bug fixes: https://bugzilla.redhat.com/buglist.cgi?classification=Community&target_release=1.7.1&query_format=advanced&bug_status=CLOSED&product=Zanata
-
-## zanata-1.7.0
- * UI Improvements
- * Bug fixes: https://bugzilla.redhat.com/buglist.cgi?classification=Community&target_release=1.6.2&target_release=1.7&query_format=advanced&bug_status=CLOSED&product=Zanata
- * Don't enforce locales for source documents
- * On-Demand copy trans
- * Email log appender
- * Centralise management of key shortcuts in Zanata
- * Improvements to reindexing (processing in small batches, index classes separately)
- * Editor validation for XML entities
- * Undo button for saved translations
- * Translation Memory merge in editor
- * Add support for positional strings in printf validator
- * Translation Memory now uses word-based indexing
-
-
-## zanata-1.6.1
- * Bug fixes: https://bugzilla.redhat.com/buglist.cgi?classification=Community&target_release=1.6.1&query_format=advanced&bug_status=CLOSED&product=Zanata
- * Allow Zanata to add locales for which plural form is not known
-
-## zanata-1.6.0
- * UI Improvements
- * Bug fixes: https://bugzilla.redhat.com/buglist.cgi?classification=Community&target_release=1.6&target_release=1.6-alpha-1&target_release=1.6-beta-1&query_format=advanced&bug_status=CLOSED&product=Zanata
- * Allow Project Maintainers to edit all language files
- * Glossary suggestions
- * Add the ability to specify custom locales that are not enabled by default
- * Upgrade Liquibase to version 2.0
- * Project grouping
- * Support plural forms
- * Offline translation feature via web UI
- * Allow translators to push translations using Maven client
- * Indicators for simultaneous edits
- * Java style variable validations in translation editor
- * "Create Project" for non-administrator users
- * Display page context in window title
- * Ability to monitor Zanata server statistics (JavaMelody)
- * Overview for available keyboard shortcuts in web editor
-
-## zanata-1.5.0
- * Allow bookmarking of selected document, document list filter and current view: https://bugzilla.redhat.com/show_bug.cgi?id=757621
- * Add workspace query string parameters for generating a custom doclist with a custom title: https://bugzilla.redhat.com/show_bug.cgi?id=758587
- * e.g. &title=Custom%20title&doc=full/path/of/first/doc&doc=full/path/of/second/doc
- * Redesign of color scheme translation editor workspace layout
- * Project/project iteration status changes: ACTIVE, READONLY, and OBSOLETE
- * Allow readonly access to retired project/project iteration: https://bugzilla.redhat.com/show_bug.cgi?id=755759
- * Implement filter messages in the editor by translation status: https://bugzilla.redhat.com/show_bug.cgi?id=773459
- * Implement validation in editor:
- * Newline validation on leading and trailing string: https://bugzilla.redhat.com/show_bug.cgi?id=768802
- * Variables to be checked for consistency: https://bugzilla.redhat.com/show_bug.cgi?id=769471
- * XML and HTML tags to be checked for completeness: https://bugzilla.redhat.com/show_bug.cgi?id=756235
- * Project list filtering based on status
- * Overall statistics page for Admin
- * Add file download page with the option to download a single PO file, or a zip with a project iteration's files for one locale
- * Translation memory results now have highlighted differences
- * Activate entity caching
- * Maven client option to create 'skeleton' PO files when no translations are present
- * Maven client option to log detailed client-server message information
- * Generate Zanata Rest API documentation
- * Add automated compatibility tests with previous versions of the Zanata java client classes
- * Redirect to previous page after sign in
- * Several UI updates and changes
- * Bug fixes:
- * Rapid key navigation causes backlog of TM queries: https://bugzilla.redhat.com/show_bug.cgi?id=785034
- * Long strings slow down the operation: https://bugzilla.redhat.com/show_bug.cgi?id=750956
- * "Participants" information is incorrect.: https://bugzilla.redhat.com/show_bug.cgi?id=756292
- * Translation editor: Long word in source cell invades the editor cell: https://bugzilla.redhat.com/show_bug.cgi?id=759337
- * On push operations, copyTrans runs too slowly: https://bugzilla.redhat.com/show_bug.cgi?id=746899
- * Edit profile: "duplicate email" is shown even if user press save without changing email: https://bugzilla.redhat.com/show_bug.cgi?id=719176
- * Translation editor table shows changes which failed to save: https://bugzilla.redhat.com/show_bug.cgi?id=690669
-
-## zanata-1.4.5.2
- * Fix handling of fuzzy entries when saving Properties files
-
-## zanata-1.4.5.1
- * Fix regression with Unicode encoding for ordinary (Latin-1) .properties files: https://bugzilla.redhat.com/show_bug.cgi?id=795597
-
-## zanata-1.4.5
- * Add support for Maven modules: https://bugzilla.redhat.com/show_bug.cgi?id=742872
- * Fix bug: Moving to a new page does not refresh the translation textboxes (ghost translations): https://bugzilla.redhat.com/show_bug.cgi?id=760431
-
-
-## zanata-1.4.4
- * Ensure final reindex batch is properly flushed: https://bugzilla.redhat.com/show_bug.cgi?id=747836
- * Support UTF-8 Properties files, handle empty properties: https://bugzilla.redhat.com/show_bug.cgi?id=760390
- * Fix bug: Editor table stops working after 'Source and Target' search returns no results: https://bugzilla.redhat.com/show_bug.cgi?id=759994
- * Add dryRun option for Maven goals 'push' and 'pull'
-
-## zanata-1.4.3
- * Show message context in editor info panel: https://bugzilla.redhat.com/show_bug.cgi?id=750690
- * Update gwteventservice to 1.2.0-RC1
- * Modify email templates to include server URL
- * Fix problems with editor table when searching or switching pages: https://bugzilla.redhat.com/show_bug.cgi?id=751264
- * Add failsafe editor in case of Seam Text problems: https://bugzilla.redhat.com/show_bug.cgi?id=727716
- * Change string similarity algorithm so that only identical strings (not substrings) can get 100%: https://bugzilla.redhat.com/show_bug.cgi?id=730189
- * Bugfix: 'J' and 'K' navigation keys trigger when entering text in the TM search box: https://bugzilla.redhat.com/show_bug.cgi?id=754637
- * Bugfix: Not able to work in parallel on the same workbench: https://bugzilla.redhat.com/show_bug.cgi?id=756293
- * Show progress during re-index operations; avoid timeout for large databases: https://bugzilla.redhat.com/show_bug.cgi?id=747836
-
-## zanata-1.4.2
- * Language team coordinator: https://bugzilla.redhat.com/show_bug.cgi?id=742083
- * Users now have to ask before joining a language team
- * Coordinator can add and remove team members
- * Contact coordinators
- * Contact server admins: https://bugzilla.redhat.com/show_bug.cgi?id=742854
- * First/last entry button: https://bugzilla.redhat.com/show_bug.cgi?id=743783
- * Load project pages faster: https://bugzilla.redhat.com/show_bug.cgi?id=744114
- * Option for Enter to save translation: https://bugzilla.redhat.com/show_bug.cgi?id=744671
- * Sort projects by name, not ID: https://bugzilla.redhat.com/show_bug.cgi?id=746859
- * Make newlines visible to reduce newline mismatch errors in translations: https://bugzilla.redhat.com/show_bug.cgi?id=740122
- * Improve shortcut keys: https://bugzilla.redhat.com/show_bug.cgi?id=740191
- * Fix tab order: editor cell -> Save as Approved -> Save as Fuzzy -> Cancel
- * Save as Fuzzy now leaves the cell editor open: https://bugzilla.redhat.com/show_bug.cgi?id=746870
- * Modal navigation: next fuzzy, untranslated, fuzzy or untranslated: https://bugzilla.redhat.com/show_bug.cgi?id=743134
- * Rearrange various UI elements to be more logical (profile page, document stats, project search field)
-
-## zanata-1.4.1
- * Fixed: % completed should be calculated with words, not messages: https://bugzilla.redhat.com/show_bug.cgi?id=741523
- * Fixed: Selecting Administration submenu items does not always highlight the parent menu: https://bugzilla.redhat.com/show_bug.cgi?id=724867
- * Fixed: Change of tile to list view on Language page, make project list sortable: https://bugzilla.redhat.com/show_bug.cgi?id=742111
- * Performance fix for projects with 1000+ documents: https://bugzilla.redhat.com/show_bug.cgi?id=743179
-
-## zanata-1.4
- * add project-type to zanata.xml for generic push/pull commands
- * redirect to login from translation editor when required
- * if domain is left blank by admin, don't populate email address for new users
- * UI bug fixes
-
-## zanata-1.4-alpha-1
- * create generic push/pull commands, with include/exclude filters
- * add support for Java Properties and XLIFF projects
- * bug fix: mark existing translations of modified XLIFF/Properties strings as fuzzy
- * modify keyboard shortcuts in editor
- * add new Zanata logo/favicon
- * various UI improvements
- * auto-size for translation text area
- * add icons to buttons and remove text
- * add option to hide editor buttons
- * remove Clone and Save button; move Copy button to middle
- * autosave when leaving a cell
- * remove Fuzzy checkbox; add Save as Fuzzy
- * better statistics graphs
- * display resource IDs for translation units
- * add ability to hide translation unit details
- * show translation states with coloured side bars, and italics for Fuzzy
- * recalculate missing word counts
- * bug fixes
-
-## zanata-1.3.1 (never released)
- * add liquibase script
- * bug fix for search re-indexing by admin
- * copy translations of identical strings when importing new documents
- * bug fixes and improvements for UI
- * bug fix for word counts (thread safety)
- * remove email address from Language Team pages
- * enable stats for anonymous users
- * no need to enforce locales for source documents
- * bug fix for push/merge when PO files are missing some msgids
-
-## zanata-1.3
- * bug fixes for authentication and for source comments
-
-## zanata-1.3-alpha-3
- * finalise rebrand from flies->zanata: XML namespaces, media types, etc
- * more logging for authentication errors
- * bug fix for Kerberos authentication
-
-## zanata-1.3-alpha-2
- * switch source control to git on github
- * rebrand from flies->zanata (maven artifacts, java packages, mailing lists)
- * Fedora authentication rhbz#692011
- * generate zanata.xml config file (http://code.google.com/p/flies/issues/detail?id=282)
- * merge translations on import (http://code.google.com/p/flies/issues/detail?id=28)
- * preserve and generate PO header comments for translator credits (http://code.google.com/p/flies/issues/detail?id=269)
- * bug fixes
-
-## zanata-1.3-alpha-1
- * rebrand from flies->zanata (except URIs, maven artifacts and java packages)
- * specify locales per project/version (http://code.google.com/p/flies/issues/detail?id=261)
- * added tab for home page, removed project list, contents editable by admin (http://code.google.com/p/flies/issues/detail?id=279)
- * added help page/tab, contents editable by admin (http://code.google.com/p/flies/issues/detail?id=280)
- * removed name and description from project version (http://code.google.com/p/flies/issues/detail?id=281)
- * stats for all languages (http://code.google.com/p/flies/issues/detail?id=275)
- * workaround for form/login issue on Firefox 4.0 rhbz#691963
- * bug fixes
-
-## flies-1.2
- * disabled bad key bindings (http://code.google.com/p/flies/issues/detail?id=262)
- * fixed python client issue with PotEntryHeader.extractedComment (http://code.google.com/p/flies/issues/detail?id=256)
- * web template redesign (new logo, CSS) (http://code.google.com/p/flies/issues/detail?id=238)
- * fixed Seam integration tests (http://code.google.com/p/flies/issues/detail?id=231)
-
-## flies-1.2-alpha-3
- * improve notifications in editor (http://code.google.com/p/flies/issues/detail?id=191)
- * highlight search terms in editor (http://code.google.com/p/flies/issues/detail?id=227)
-
-## flies-1.2-alpha-2
- * better messages
- * bug fixes
-
-## flies-1.2-alpha-1
- * development change: re-arranged Maven modules into common, client and server
-
-## flies-1.1.1
- * use word counts in translation statistics (http://code.google.com/p/flies/issues/detail?id=203)
- * bug fixes
-
-## flies-1.1
- * Kerberos/JAAS fixes
- * require name & email address on first login for JAAS/Kerberos
- * validate changes to email address
- * use correct BCP-47 language tags (zh-CN-Hans is now zh-Hans-CN)
-
-## flies-1.1-alpha-1
- * JAAS authentication
- * Kerberos authentication
- * remove communities tab and my communities UI (http://code.google.com/p/flies/issues/detail?id=197)
- * remove "Language Missing" button (http://code.google.com/p/flies/issues/detail?id=185)
- * show member number for the language groups (http://code.google.com/p/flies/issues/detail?id=186)
- * allow overriding POT directory in Maven client (http://code.google.com/p/flies/issues/detail?id=200)
- * support `[servers]` in flies.ini for Maven client (http://code.google.com/p/flies/issues/detail?id=193)
- * better info/error messages in Maven client
-
-## flies-1.0.3
- * fix TM caching issue (http://code.google.com/p/flies/issues/detail?id=190)
- * add 'translator' role and security rules
- * configurable URLs
-
-## flies-1.0.2
- * minor UI fixes (http://code.google.com/p/flies/issues/detail?id=173, http://code.google.com/p/flies/issues/detail?id=176)
- * ergonomics for Maven client
- * UI for assigning project maintainers (http://code.google.com/p/flies/issues/detail?id=180)
- * better error checking in REST API (http://code.google.com/p/flies/issues/detail?id=175)
- * security rule fix (http://code.google.com/p/flies/issues/detail?id=182)
-
-## flies-1.0.1
- * database schema fixes
- * fixes for deployment issues
-
-## flies-1.0
- * initial release
diff --git a/docs/configuration/authentication.md b/docs/configuration/authentication.md
index 2919352d22..85b0c41b40 100644
--- a/docs/configuration/authentication.md
+++ b/docs/configuration/authentication.md
@@ -206,7 +206,6 @@ standalone.xml:
### Single Provider
-_( As of version 3.5.1 )_
It's possible to configure Zanata to use a single pre-defined Open Id authentication provider. To do this, just add an extra `module-option` to the `login-module` element, like this:
```xml
diff --git a/docs/configuration/infinispan.md b/docs/configuration/infinispan.md
index 4973ddc7a3..d8eedaa0ed 100644
--- a/docs/configuration/infinispan.md
+++ b/docs/configuration/infinispan.md
@@ -1,11 +1,6 @@
-# Infinispan
+# Infinispan for caching
-_This section is still under review and is about features that have not been released yet_
-
-Zanata uses Infinispan to manage its internal data caches and search indexes. Configuration for these caches happens in JBoss' `standalone/configuration/standalone.xml`. There are two different caches that need to be configured for Zanata:
-
-1. Hibernate search Indexes
-1. Other internal data caches
+Zanata uses Infinispan to manage some of its internal data caches. Configuration for these caches happens in JBoss' `standalone/configuration/standalone.xml`.
The Infinispan configuration will be located inside the following module in `standalone.xml`:
@@ -17,40 +12,14 @@ The Infinispan configuration will be located inside the following module in `sta
Keep in mind that the module version may vary depending on your JBoss version.
-### Hibernate Cache
-
-The following is the recommended configuration for the Hibernate cache:
+### Configuration for Internal data caches
```xml
...
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-...
-```
-
-Depending on your JBoss installation, the hibernate cache might already be present in the configuration, in which case there is no need to create another one, but just modify it.
-
-### Other internal data caches
-
-```xml
-...
-
+
@@ -59,3 +28,5 @@ Depending on your JBoss installation, the hibernate cache might already be prese
...
```
+
+*Please see the JBoss EAP or Wildfly documentation for more options on cache configuration.*
diff --git a/docs/configuration/installation.md b/docs/configuration/installation.md
new file mode 100644
index 0000000000..44d9378681
--- /dev/null
+++ b/docs/configuration/installation.md
@@ -0,0 +1,109 @@
+Zanata can be installed by downloading a web archive (war) file, and configuring Jboss EAP or Wildfly according to this guide, or by downloading a handy installer.
+
+## What you need
+
+- JBoss Enterprise Application Platform 6.3 (EAP). This is the recommended container for Zanata, and it can be [downloaded here](http://www.jboss.org/jbossas/downloads/).
+- ... OR Wildfly (recommended version is 8.1.x) which can be [downloaded here](http://wildfly.org/downloads/)
+- A suitable MySQL database. This is NOT included in the Zanata archive. You can [download MySQL here](http://dev.mysql.com/downloads/mysql/).
+- An email (SMTP) server to perform certain notifications.
+- JDK version 7 or later (7 is recommended for EAP as it is not yet certified to run against Java 8). [OpenJDK](http://openjdk.java.net/install/) is recommended, but you can also download [Oracle's JDK](http://www.oracle.com/technetwork/java/javase/downloads/index.html)
+
+The following packages are optional, but recommended:
+
+- clamav for virus protection.
+
+## Setting up the Zanata Database
+
+ 1. Download and install MySQL 5 from the [MySQL download page](http://dev.mysql.com/downloads/mysql/).
+ Zanata has been thoroughly tested against MySQL 5 and the Zanata team therefore recommends that you install and use this version with Zanata.
+
+ 1. Start MySQL service and create a database schema for Zanata.
+ `CREATE DATABASE zanata /**!40100 DEFAULT CHARACTER SET utf8 **/;`
+
+## Installing Zanata
+
+You can run Zanata on JBoss EAP 6 or Wildfly. Just download one of the installer archives below for your platform, and then extract it on top of your JBoss or Wildfly installation.
+
+- [Zanata for JBoss EAP](http://sourceforge.net/projects/zanata/files/installer/zanata-3.6.0-eap-6.zip/download)
+- [Zanata for Wildfly](http://sourceforge.net/projects/zanata/files/installer/zanata-3.6.0-wildfly-8.1.zip/download)
+
+## Run the installer
+
+Zanata comes bundled with an installer that helps with some of the initial setup. Simply run the following commands on a shell terminal:
+
+```sh
+$ cd /bin/zanata-installer
+$ ./install.sh
+```
+
+(there's also a .bat file if you are on Windows) The installation script will start asking some configuration questions. It will also download the Zanata web application and place it in the JBoss installation.
+
+## Some advanced configuration
+
+Zanata does not create an admin user by default. You need to register specific users to have administrative privileges.
+
+ 1. Open the `/standalone/configuration/standalone.xml` file.
+
+ 1. Locate the following line, and replace `admin` with a comma-separated list of users that require administrator privileges on the system.
+
+```xml
+
+```
+
+ 1. Register a user under the name "admin", and it will automatically have administrator privileges. Any number of users may be added to this list in a comma-separated format.
+
+ 1. In the same file, configure other properties to your particular setup by adding more lines if necessary. The following properties must be configured in order for Zanata to run properly:
+```xml
+
+```
+
+ This is the default email address that will appear as the sender on Zanata emails.
+
+ 1. The following properties relate to the SMTP email server that Zanata uses to send emails. It defaults to a locally installed server using port 25. Add values to suit your configuration. If a particular property does not apply to the email server being used, you can comment it out or remove it completely.
+
+```xml
+
+
+
+
+
+
+```
+
+## Installing virus scanner (optional)
+
+To prevent virus infected document being uploaded, Zanata is capable of working with clamav.
+If clamav is not installed, a warning will be logged when files are uploaded.
+If clamav is installed but `clamd` is not running,
+Zanata may reject all uploaded files (depending on file type). To install and run clamav:
+```
+# Assuming the function install_missing() is still available
+if [ -e /usr/bin/systemctl ];then
+ install_missing clamav-server clamav-scanner-systemd
+ sudo systemctl enable clamd@scan
+ sudo systemctl start clamd@scan
+else
+ install_missing clamd
+ sudo chkconfig clamd on
+ if ! service clamd status ;then
+ sudo service clamd start
+ fi
+fi
+```
+
+You should probably also ensure that freshclam is set to run at least once per day,
+to keep virus definitions up to date.
+The clamav package will probably do this for you, but you can check by looking for `/etc/cron.daily/freshclam`.
+To override the default behaviour above, you can set the system property `virusScanner` when running the server.
+`DISABLED` means no virus scanning will be performed; all files will be assumed safe.
+Any other value will be treated as the name of a virus scanner command: the command will be called with the name of a file to scan.
+
+## Running Zanata
+
+Go to the `/bin` directory and run the `standalone.sh` (Linux, Mac) or `standalone.bat` (Windows) file.
+
+## Using Zanata
+
+To start using your Zanata server, open a browser and navigate to `http://localhost:8080/zanata`
+
+You can now upload some source strings and start translating. To get started, see [Adding Source Strings](user-guide/projects/upload-strings).
\ No newline at end of file
diff --git a/docs/images/project-view-versions.png b/docs/images/project-view-versions.png
new file mode 100644
index 0000000000..b73fad68e1
Binary files /dev/null and b/docs/images/project-view-versions.png differ
diff --git a/docs/images/version-merge-trans-cancel.png b/docs/images/version-merge-trans-cancel.png
new file mode 100644
index 0000000000..8eddac8038
Binary files /dev/null and b/docs/images/version-merge-trans-cancel.png differ
diff --git a/docs/images/version-merge-trans-dialog.png b/docs/images/version-merge-trans-dialog.png
new file mode 100644
index 0000000000..b03ed7d790
Binary files /dev/null and b/docs/images/version-merge-trans-dialog.png differ
diff --git a/docs/images/version-merge-trans-progress.png b/docs/images/version-merge-trans-progress.png
new file mode 100644
index 0000000000..d2df13775e
Binary files /dev/null and b/docs/images/version-merge-trans-progress.png differ
diff --git a/docs/images/version-more-action-menu.png b/docs/images/version-more-action-menu.png
new file mode 100644
index 0000000000..538ebd23c5
Binary files /dev/null and b/docs/images/version-more-action-menu.png differ
diff --git a/docs/images/version-view-languages.png b/docs/images/version-view-languages.png
new file mode 100644
index 0000000000..e54b3fd3cd
Binary files /dev/null and b/docs/images/version-view-languages.png differ
diff --git a/docs/index.md b/docs/index.md
index f5258d6982..003e2669fc 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,31 +1,22 @@
Zanata Server
=============
-
-TBD
-
-Features
---------
-
-- TBD
+Please visit [About|Zanata](http://zanata.org/about/)
Installation
------------
-
+[Installation section](configuration/installation.md)
Contribute
----------
-- Issue Tracker: http://bugzilla.redhat.com
-- Source Code: github.com/zanata/zanata-server
+- [Issue Tracker](http://bugzilla.redhat.com/buglist.cgi?product=Zanata)
+- [Source Code on GitHub](http://github.com/zanata)
Support
-------
-
-If you are having issues, please let us know.
-We have a mailing list located at: zanata-users@redhat.com
+For help and support options, see [Help|Zanata](http://zanata.org/help/)
License
-------
-
-
\ No newline at end of file
+Zanata is Free software, licensed under the [LGPL](http://www.gnu.org/licenses/lgpl-2.1.html).
\ No newline at end of file
diff --git a/docs/release-notes.md b/docs/release-notes.md
index 4da242c100..25be520f4d 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,3 +1,47 @@
+## 3.7
+
+
Infrastructure Changes
+
+* Zanata now uses Infinispan as its cache provider, and the cache needs to be configured in Jboss' `standalone.xml` file. Please see the [Infinispan](configuration/infinispan) section for more information.
+
+* This release adds a one-time migration of some data, which can cause a timeout during server startup. This applies to
+all plain text and libreoffice formats, so is only a concern for servers that are upgrading from an earlier version and
+already have several hundred such documents. To avoid the timeout, add or change the following property in
+`standalone.xml`. A value of 1000 seconds is sufficient in our tests. Since the migration is performed only once, the
+property can safely be reverted or removed before subsequent startups.
+
+
+ ...
+
+
+
+
+
Bug fixes
+* [1194543](https://bugzilla.redhat.com/show_bug.cgi?id=1194543) - Manual document re-upload makes previous translations fuzzy
+* [1029734](https://bugzilla.redhat.com/show_bug.cgi?id=1029734) - po header contains invalid entry will cause upload/push failure
+
+-----------------------
+
+
+* [1194543](https://bugzilla.redhat.com/show_bug.cgi?id=1194543) - Manual document re-upload makes previous translations fuzzy
+* [1197902](https://bugzilla.redhat.com/show_bug.cgi?id=1197902) - Large translated document push times are inconsistent
+* [1183412](https://bugzilla.redhat.com/show_bug.cgi?id=1183412) - Emails to administrators are sent in the current interface language
+* [1202670](https://bugzilla.redhat.com/show_bug.cgi?id=1202670) - There should be visual clues to indicate active, readonly, and archived versions.
+* [875965](https://bugzilla.redhat.com/show_bug.cgi?id=875965) - Enable visible white space in source
+* [1205465](https://bugzilla.redhat.com/show_bug.cgi?id=1205465) - User emails are visible to non admin users in Language page
+* [1205468](https://bugzilla.redhat.com/show_bug.cgi?id=1205468) - Sorting mechanism broken on Languages page
+* [1205046](https://bugzilla.redhat.com/show_bug.cgi?id=1205046) - Key shortcuts are not all visible on a small window
+* [1000273](https://bugzilla.redhat.com/show_bug.cgi?id=1000273) - Font in TM and font in Editor Not matching
+* [1013928](https://bugzilla.redhat.com/show_bug.cgi?id=1013928) - Editor options panel cannot scroll on small screens
+
+----
+
## 3.6
New Editor (Alpha)
@@ -22,7 +66,7 @@ Zanata now requires JMS to be configured in standalone.xml in order to queue up
New Features
* [1044261](https://bugzilla.redhat.com/show_bug.cgi?id=1044261) - Drupal integration with Zanata
-* [1066780](https://bugzilla.redhat.com/show_bug.cgi?id=1066780) - RFE: Improve the project list page [proto]
+
* [1127066](https://bugzilla.redhat.com/show_bug.cgi?id=1127066) - Copy Version button on project version listing
* [1162383](https://bugzilla.redhat.com/show_bug.cgi?id=1162383) - Updated pages in Administration section
* [1120457](https://bugzilla.redhat.com/show_bug.cgi?id=1120457) - Email notify the user when the language team permissions change
@@ -31,9 +75,10 @@ Zanata now requires JMS to be configured in standalone.xml in order to queue up
* [1127056](https://bugzilla.redhat.com/show_bug.cgi?id=1127056) - Migration Guide for community users
* [1122776](https://bugzilla.redhat.com/show_bug.cgi?id=1122776) - WebHooks callback API
* [1186951](https://bugzilla.redhat.com/show_bug.cgi?id=1186951) - Zanata Overlay module
+* [1183994](https://bugzilla.redhat.com/show_bug.cgi?id=1183994) - RFE: Gather and display metrics detailing the number of words translated by a specific translator, for a specific project
-
Bugfixes
+
Bug fixes
* [1132271](https://bugzilla.redhat.com/show_bug.cgi?id=1132271) - Access contact admin url without logging in will trigger an exception
* [1082448](https://bugzilla.redhat.com/show_bug.cgi?id=1082448) - Dashboard shows incorrect number of maintained projects
* [1069951](https://bugzilla.redhat.com/show_bug.cgi?id=1069951) - Empty string in adding a language causes a broken language to be added
@@ -47,7 +92,7 @@ Zanata now requires JMS to be configured in standalone.xml in order to queue up
* [1185134](https://bugzilla.redhat.com/show_bug.cgi?id=1185134) - Placeholder text in server config ToU field valid, but rejected
* [1185170](https://bugzilla.redhat.com/show_bug.cgi?id=1185170) - Create version in a project is always created as read only
* [1186084](https://bugzilla.redhat.com/show_bug.cgi?id=1186084) - WebUI is very slow if users cannot access Google
-* [1186997](https://bugzilla.redhat.com/show_bug.cgi?id=1186997) - Introduction of hornetq-ra breaks the overlay installer
+* [1186997](https://bugzilla.redhat.com/show_bug.cgi?id=1186997) - Introduction of hornetq-ra breaks the overlay installer
* [1192271](https://bugzilla.redhat.com/show_bug.cgi?id=1192271) - For gettext plural project, project-version statistics was inconsistent between language and document, sometime more than 100%
* [1193699](https://bugzilla.redhat.com/show_bug.cgi?id=1193699) - Bookmarked url (selected language or selected doc) in version page, bookmarked url selected language, selected project in version-group page not working
@@ -107,7 +152,7 @@ Zanata now requires JMS to be configured in standalone.xml in order to queue up
* [988202](https://bugzilla.redhat.com/show_bug.cgi?id=988202) - RFE: REST API rate limiting
* [1002378](https://bugzilla.redhat.com/show_bug.cgi?id=1002378) - RFE: Introduce a modular translation structure, and gwt generate the *Messages.properties files
* [1066701](https://bugzilla.redhat.com/show_bug.cgi?id=1066701) - RFE: As a Zanata user, I would like to be able to bookmark language and project selections in the groups page
- * Now is possible to bookmark a project version, language, or setting item for communication or later reference.
+ * Now is possible to bookmark a project version, language, or setting item for communication or later reference.
* [1066756](https://bugzilla.redhat.com/show_bug.cgi?id=1066756) - RFE: Merge user settings pages into dashboard
* [1066796](https://bugzilla.redhat.com/show_bug.cgi?id=1066796) - RFE: Implement new project page
* [1077439](https://bugzilla.redhat.com/show_bug.cgi?id=1077439) - RFE: Use lucene indexes to do Copy Trans.
@@ -126,7 +171,7 @@ Zanata now requires JMS to be configured in standalone.xml in order to queue up
* [1086036](https://bugzilla.redhat.com/show_bug.cgi?id=1086036) - Project / version language listing and inheritance issue
* [1088651](https://bugzilla.redhat.com/show_bug.cgi?id=1088651) - New About tab does not handle existing project Seam text
* [1088737](https://bugzilla.redhat.com/show_bug.cgi?id=1088737) - Project type for a version is null after creation if the project type setting is not touched
-* [1094071](https://bugzilla.redhat.com/show_bug.cgi?id=1094071) - Copy Translations information not correct
+* [1094071](https://bugzilla.redhat.com/show_bug.cgi?id=1094071) - Copy Translations information not correct
* [1094090](https://bugzilla.redhat.com/show_bug.cgi?id=1094090) - TMX import/export blocked by api not providing user key
* [1096564](https://bugzilla.redhat.com/show_bug.cgi?id=1096564) - Entering garbage at the end of a projects url breaks navigation
* [1097940](https://bugzilla.redhat.com/show_bug.cgi?id=1097940) - New password field should have show/hide toggle
@@ -157,7 +202,7 @@ Zanata now requires JMS to be configured in standalone.xml in order to queue up
New Features
* [978072](https://bugzilla.redhat.com/show_bug.cgi?id=978072) - RFE: support roff as an input/output format
- * This feature is implemented on the client side only with [1038449 - command hook](https://bugzilla.redhat.com/show_bug.cgi?id=1038449). Users who wish to push .roff file can use a command hook to invoke external tool (po4a) before push to convert .roff into .pot. Invoke po4a again after pull to convert translated .po into .roff.
+ * This feature is implemented on the client side only with [1038449 - command hook](https://bugzilla.redhat.com/show_bug.cgi?id=1038449). Users who wish to push .roff file can use a command hook to invoke external tool (po4a) before push to convert .roff into .pot. Invoke po4a again after pull to convert translated .po into .roff.
* [1036435](https://bugzilla.redhat.com/show_bug.cgi?id=1036435) - RFE: Upgrade to Liquibase 3.x
* [980670](https://bugzilla.redhat.com/show_bug.cgi?id=980670) - [RFE] Add HTML as an input method to be translated
@@ -210,4 +255,549 @@ Zanata now requires JMS to be configured in standalone.xml in order to queue up
* [1060621](https://bugzilla.redhat.com/show_bug.cgi?id=1060621) - [Regression] Validation warnings panel not displayed
* [1044768](https://bugzilla.redhat.com/show_bug.cgi?id=1044768) - Zanata does not pull the latest changes in translation due to unchanged ETags
* [1063112](https://bugzilla.redhat.com/show_bug.cgi?id=1063112) - Client push in dryRun mode should not invoke CopyTrans
-* [1069428](https://bugzilla.redhat.com/show_bug.cgi?id=1069428) - Various concurrency problems due to unsafe Seam injections
\ No newline at end of file
+* [1069428](https://bugzilla.redhat.com/show_bug.cgi?id=1069428) - Various concurrency problems due to unsafe Seam injections
+
+-----------------------
+
+## 3.0.0
+
New Features
+
+* [980659](https://bugzilla.redhat.com/show_bug.cgi?id=980659) - TMX import/export
+ * Imported TMX shown in translation memory search results
+ * Allow users to export translations to TMX (from Project/Version pages)
+ * Allow admins to export **all** project translations to TMX (from Projects page)
+ * Allow admins to import and export TMX translation memories (from Admin pages)
+
+* [953734](https://bugzilla.redhat.com/show_bug.cgi?id=953734) - Translation review/approval
+ * Coordinators can assign reviewers for their languages
+ * Project maintainers can require review for translations in their projects
+
+* [979285](https://bugzilla.redhat.com/show_bug.cgi?id=979285) - Implement virus scanning using ClamAV (clamdscan)
+* [978666](https://bugzilla.redhat.com/show_bug.cgi?id=978666) - Translators and reviewers can add comments to translations
+* [844819](https://bugzilla.redhat.com/show_bug.cgi?id=844819) - New visual style for Zanata
+* [1066756](https://bugzilla.redhat.com/show_bug.cgi?id=1066756) - Add user dashboard
+* [981064](https://bugzilla.redhat.com/show_bug.cgi?id=981064) - Recent translation/review activity
+* Upgrade platform to JBoss EAP 6.1
+* Add descriptions on project type selectors
+* Allow adapter parameters to be set on source document upload
+* Editor improvements
+* Add attention key shortcut: Alt+X
+* Add attention shortcut to copy from source: Alt+X,G
+* File upload
+* Move raw document storage to file system
+
+-----------------------
+
+## 2.3.2
+
+* [958350](https://bugzilla.redhat.com/show_bug.cgi?id=958350) - Concurrent save on different row causes incorrect validation warnings in current row
+* [959060](https://bugzilla.redhat.com/show_bug.cgi?id=959060) - Generated Zanata config file contains invalid project type
+* [961163](https://bugzilla.redhat.com/show_bug.cgi?id=961163) - shift-w and g erroneously triggers Copy from Source
+* [959115](https://bugzilla.redhat.com/show_bug.cgi?id=959115) - Database connection pool leaks under load
+
+-----------------------
+
+## 2.3.1
+
Bug fixes
+
+* [953195](https://bugzilla.redhat.com/show_bug.cgi?id=953195) - HQL query exception while trying to filter strings
+* Prevent incorrect validation warnings with concurrent edits
+* Search result back to editor causes multiple code mirror focus
+* Support message bookmark
+
+-----------------------
+
+## 2.3.0
+
+* [908548](https://bugzilla.redhat.com/show_bug.cgi?id=908548) - Long document names cause layout issues in Doc page
+* [786630](https://bugzilla.redhat.com/show_bug.cgi?id=786630) - Shortcut Alt+G causes editor to lose focus
+* [870876](https://bugzilla.redhat.com/show_bug.cgi?id=870876) - PO download for non-PO projects cannot be uploaded
+* [846314](https://bugzilla.redhat.com/show_bug.cgi?id=846314) - Show validation state in doc list and link to error-filter view in editor
+* [844553](https://bugzilla.redhat.com/show_bug.cgi?id=844553) - Notification of an entry should have a link that go to the entry
+* [727826](https://bugzilla.redhat.com/show_bug.cgi?id=727826) - Order Projects alphabetically
+* [917911](https://bugzilla.redhat.com/show_bug.cgi?id=917911) - Keep "Validation Warnings: n" displayed even when moving focus to different pages
+* [910637](https://bugzilla.redhat.com/show_bug.cgi?id=910637) - Keep "Validation Warnings: n" displayed even when moving focus to different entry
+* [767055](https://bugzilla.redhat.com/show_bug.cgi?id=767055) - Error when pull as XLIFF file format: Underlying stream encoding 'ASCII' and input parameter for writeStartDocument() method 'utf-8' do not match
+* [953361](https://bugzilla.redhat.com/show_bug.cgi?id=953361) - Source document name search triggers delete confirmation
+* [874335](https://bugzilla.redhat.com/show_bug.cgi?id=874335) - Allow admins to see the email addresses of project maintainers
+* [950806](https://bugzilla.redhat.com/show_bug.cgi?id=950806) - Notification links disappear from list when detail is viewed
+* [947832](https://bugzilla.redhat.com/show_bug.cgi?id=947832) - Empty translation page when pushing next
+* [923461](https://bugzilla.redhat.com/show_bug.cgi?id=923461) - Update document list view and link to the violated entries after project wide validation
+* [910183](https://bugzilla.redhat.com/show_bug.cgi?id=910183) - Search in Document List does not show when on page 2+ of Document List
+* [854087](https://bugzilla.redhat.com/show_bug.cgi?id=854087) - report which locales have recent changes
+
+-----------------------
+
+## 2.2.2
+
+* [917895](https://bugzilla.redhat.com/show_bug.cgi?id=917895) - Validation rules should be enabled by default
+* [917897](https://bugzilla.redhat.com/show_bug.cgi?id=917897) - AlreadyClosedException when new document uploaded and translated
+* [807100](https://bugzilla.redhat.com/show_bug.cgi?id=807100) - Removing admin role doesn't take effect for Kerberos authentication
+
+-----------------------
+
+## 2.2.1
+
+* [915130](https://bugzilla.redhat.com/show_bug.cgi?id=915130) - Unexpected error when clicking "resend activation email" or "update email address"
+* [916812](https://bugzilla.redhat.com/show_bug.cgi?id=916812) - Activation Key should update after user click "Resend activation email" and "Change email"
+
+-----------------------
+
+## 2.2.0
+
+* [895280](https://bugzilla.redhat.com/show_bug.cgi?id=895280) - Persist project type on server
+* [893811](https://bugzilla.redhat.com/show_bug.cgi?id=893811) - Old registration activation link should expire after a given period
+* [750104](https://bugzilla.redhat.com/show_bug.cgi?id=750104) - Old email validation links for email change should expire after a given period
+* [913373](https://bugzilla.redhat.com/show_bug.cgi?id=913373) - Ctrl-Enter not moving to next trans unit if there are no changes
+* [908563](https://bugzilla.redhat.com/show_bug.cgi?id=908563) - Html Xml tag validation will produce exception in certain case
+* [912583](https://bugzilla.redhat.com/show_bug.cgi?id=912583) - Change project type 'raw' to be 'file'
+* [910216](https://bugzilla.redhat.com/show_bug.cgi?id=910216) - Statistics API returns word level statistics when only message level statistics are requested
+* [910212](https://bugzilla.redhat.com/show_bug.cgi?id=910212) - Ability to resume push/pull from a specified document
+* [903470](https://bugzilla.redhat.com/show_bug.cgi?id=903470) - Allow java clients to send and receive source control URLs for projects
+* [896356](https://bugzilla.redhat.com/show_bug.cgi?id=896356) - Need to specify the size of the stream when sending a file (or part thereof)
+* [896299](https://bugzilla.redhat.com/show_bug.cgi?id=896299) - store and display source control URL
+* [895295](https://bugzilla.redhat.com/show_bug.cgi?id=895295) - Validator to warn of inconsistent number of lines
+* [913745](https://bugzilla.redhat.com/show_bug.cgi?id=913745) - Zip File download does not work
+* [913331](https://bugzilla.redhat.com/show_bug.cgi?id=913331) - "Contact Team Coordinator" return unexpected error
+* [913310](https://bugzilla.redhat.com/show_bug.cgi?id=913310) - Value in zanata.properties does not shows up in server configuration page
+* [912590](https://bugzilla.redhat.com/show_bug.cgi?id=912590) - Project maintainer should be able to "edit page code"
+* [909032](https://bugzilla.redhat.com/show_bug.cgi?id=909032) - Project version's project type should default to that of the project
+* [909026](https://bugzilla.redhat.com/show_bug.cgi?id=909026) - Unexpected error when trying to download config file when project-type not set on version
+* [903926](https://bugzilla.redhat.com/show_bug.cgi?id=903926) - Project maintainer should be able to define and save validations rules per project/document
+* [903477](https://bugzilla.redhat.com/show_bug.cgi?id=903477) - Workspace document list view should have same features as JSF document list view
+* [903026](https://bugzilla.redhat.com/show_bug.cgi?id=903026) - Display Last Translator and Last Modified column in the document list
+
+-----------------------
+
+## 2.1.3
+
+* [896332](https://bugzilla.redhat.com/show_bug.cgi?id=896332) - CopyTrans should use the most recent matching translation
+
+-----------------------
+
+## 2.1.1
+
+* [894909](https://bugzilla.redhat.com/show_bug.cgi?id=894909) - Kerberos user unable to log in properly
+* [888090](https://bugzilla.redhat.com/show_bug.cgi?id=888090) - Implement REST ETag mechanism for certain GET operations
+
+-----------------------
+
+## 2.1.0
+
+* [844550](https://bugzilla.redhat.com/show_bug.cgi?id=844550) - Provide sort by option on branch stats page
+* [874367](https://bugzilla.redhat.com/show_bug.cgi?id=874367) - Editor should warn before saving a Fuzzy translation as Approved from a keyboard shortcut
+* [877223](https://bugzilla.redhat.com/show_bug.cgi?id=877223) - Add "clear" button to search field in workspace
+* [878275](https://bugzilla.redhat.com/show_bug.cgi?id=878275) - Breadcrumb navigation in workspace should separate project version and locale
+* [880436](https://bugzilla.redhat.com/show_bug.cgi?id=880436) - Plain text area editor doesn't get autosize correctly with long string
+* [882739](https://bugzilla.redhat.com/show_bug.cgi?id=882739) - Tooltips on paging buttons (editor) shows shortcut keys which doesn't apply
+* [892816](https://bugzilla.redhat.com/show_bug.cgi?id=892816) - Recently removed project maintainer retains access to project maintainer actions
+* [874374](https://bugzilla.redhat.com/show_bug.cgi?id=874374) - Make translation editor options persistent
+* [880894](https://bugzilla.redhat.com/show_bug.cgi?id=880894) - Externalize Email Server configuration
+* [881549](https://bugzilla.redhat.com/show_bug.cgi?id=881549) - Allow admins to change account user names
+* [884335](https://bugzilla.redhat.com/show_bug.cgi?id=884335) - Add Translation Memory Cache for filter query
+* [891485](https://bugzilla.redhat.com/show_bug.cgi?id=891485) - Removing a locale member causes a RecordNotFound error
+* [864280](https://bugzilla.redhat.com/show_bug.cgi?id=864280) - upload/download raw file types with the Maven plugin
+* [876012](https://bugzilla.redhat.com/show_bug.cgi?id=876012) - The Content-Type of Download as po link is application/octet-stream, but should be text/plain
+* [881962](https://bugzilla.redhat.com/show_bug.cgi?id=881962) - Project-wide Search and replace starts by Enter key before ready
+* [887052](https://bugzilla.redhat.com/show_bug.cgi?id=887052) - Source and Target search in editor fails when the search term includes an apostrophe (')
+* [888150](https://bugzilla.redhat.com/show_bug.cgi?id=888150) - Case sensitive search should return case sensitive results
+* [877228](https://bugzilla.redhat.com/show_bug.cgi?id=877228) - Clearing the search field in workspace should keep position at last selected message
+* [880444](https://bugzilla.redhat.com/show_bug.cgi?id=880444) - enable spell check in code mirror editor for Firefox
+* [880879](https://bugzilla.redhat.com/show_bug.cgi?id=880879) - Undo button causing repeated save failures and other weirdness
+* [884402](https://bugzilla.redhat.com/show_bug.cgi?id=884402) - Entry should NOT move unless it is absolutely needed
+* [884502](https://bugzilla.redhat.com/show_bug.cgi?id=884502) - navigation breaks in filter mode after saved status not included in filter view
+* [887717](https://bugzilla.redhat.com/show_bug.cgi?id=887717) - enable 'Enter' key saves immediately will make pager input dysfunctional
+* [887718](https://bugzilla.redhat.com/show_bug.cgi?id=887718) - Too slow to load the last pages of a big document with Firefox
+* [888096](https://bugzilla.redhat.com/show_bug.cgi?id=888096) - project become read only with editor options panel open will still allow user to change editor options
+* [888592](https://bugzilla.redhat.com/show_bug.cgi?id=888592) - Options to customize translation editor display
+* [889411](https://bugzilla.redhat.com/show_bug.cgi?id=889411) - Red border indicating failed validation shows on strings without validation warning/error
+* [891458](https://bugzilla.redhat.com/show_bug.cgi?id=891458) - Document List search returning incorrect results
+* [885934](https://bugzilla.redhat.com/show_bug.cgi?id=885934) - option to avoid encoding tab as \t
+* [803923](https://bugzilla.redhat.com/show_bug.cgi?id=803923) - email should be able to corrected during register validation
+* [829565](https://bugzilla.redhat.com/show_bug.cgi?id=829565) - Kerberos activation link in email gets 404 page not found
+* [872039](https://bugzilla.redhat.com/show_bug.cgi?id=872039) - Escaping with single-quote (a.k.a. Apostrophes ') character in MessageFormat strings can cause confusing validation warnings
+* [886711](https://bugzilla.redhat.com/show_bug.cgi?id=886711) - Error when using pull for project type raw when the document name does not include a type extension
+* [831056](https://bugzilla.redhat.com/show_bug.cgi?id=831056) - Option for highlight only the search terms
+* [785046](https://bugzilla.redhat.com/show_bug.cgi?id=785046) - Limit source string length in properties file
+* [846643](https://bugzilla.redhat.com/show_bug.cgi?id=846643) - Shorten the navigation sequence to open a document in the Editor
+* [884386](https://bugzilla.redhat.com/show_bug.cgi?id=884386) - Email validation link should be invalid after user validate the email, or user request another validation
+
+-----------------------
+
+## 2.0.3
+
New Features
+
+* Allow admin to add extra locales by typing in the BCP-47 locale code.
+* TM Merge reports what it did
+* Allow choice of editor page size
+* Support txt, dtd and open document format (REST & web interface)
+* Editor option to disable CodeMirror (to enable browser spell-check)
+* Detect loss of connection to server
+* Fix for problem creating users with Kerberos
+* Allow Project Maintainers to Delete a Source Document
+
+[
Bug fixes | Bugzilla
](https://bugzilla.redhat.com/buglist.cgi?j_top=OR&f1=cf_fixed_in&o1=substring&classification=Community&o2=substring&query_format=advanced&f2=cf_fixed_in&bug_status=VERIFIED&bug_status=RELEASE_PENDING&bug_status=POST&bug_status=CLOSED&v1=2.0.3&product=Zanata)
+
+-----------------------
+
+## 2.0.2
+* Bug fixes for document search/navigation
+
+
+-----------------------
+
+## 2.0.1
+* Update jboss-el to avoid bad artifact in repository
+
+-----------------------
+
+## 2.0.0
+
New Features
+
+* UI redesign
+* Performance: async push service to avoid timeouts when pushing source/target
+* Performance: improve performance when loading large documents
+* Allow user to save work when concurrent edit occurs
+* Include last translator information in TM info box
+* Web analytics (Piwik integration)
+* Navigation breadcrumbs
+* Bugzilla link in UI
+* Get Stats about Translation Documents via REST
+* Remove blinking notification in editor
+* Configurable page size
+* Advanced glossary features
+* Open ID Authentication
+* Admin role assignment configuration for authentication types
+* Highlight tags in editor fields (CodeMirror for editor)
+* Translation editor rewrite
+* Project-level default Copy Trans options
+* Red bars for translations with validation warnings should stay in red when moving to the next row
+* Option to show word or message based statistics
+* Visible whitespace in editor
+* View history of translations for a text flow
+
+[
+
+* UI Improvements
+* Don't enforce locales for source documents
+* On-Demand copy trans
+* Email log appender
+* Centralise management of key shortcuts in Zanata
+* Improvements to reindexing (processing in small batches, index classes separately)
+* Editor validation for XML entities
+* Undo button for saved translations
+* Translation Memory merge in editor
+* Add support for positional strings in printf validator
+* Translation Memory now uses word-based indexing
+
+[
Bug fixes | Bugzilla
](https://bugzilla.redhat.com/buglist.cgi?classification=Community&target_release=1.6.2&target_release=1.7&query_format=advanced&bug_status=CLOSED&product=Zanata)
+
+-----------------------
+
+## 1.6.1
+* Allow Zanata to add locales for which plural form is not known
+
+[
+
+* UI Improvements
+* Allow Project Maintainers to edit all language files
+* Glossary suggestions
+* Add the ability to specify custom locales that are not enabled by default
+* Upgrade Liquibase to version 2.0
+* Project grouping
+* Support plural forms
+* Offline translation feature via web UI
+* Allow translators to push translations using Maven client
+* Indicators for simultaneous edits
+* Java style variable validations in translation editor
+* "Create Project" for non-administrator users
+* Display page context in window title
+* Ability to monitor Zanata server statistics (JavaMelody)
+* Overview for available keyboard shortcuts in web editor
+
+[
+
+* [757621](https://bugzilla.redhat.com/show_bug.cgi?id=757621) - Allow bookmarking of selected document, document list filter and current view
+* [758587](https://bugzilla.redhat.com/show_bug.cgi?id=758587) - Add workspace query string parameters for generating a custom doclist with a custom title.
+ * e.g. &title=Custom%20title&doc=full/path/of/first/doc&doc=full/path/of/second/doc
+
+* [755759](https://bugzilla.redhat.com/show_bug.cgi?id=755759) - Allow readonly access to retired project/project iteration
+* [773459](https://bugzilla.redhat.com/show_bug.cgi?id=773459) - Implement filter messages in the editor by translation status
+* [768802](https://bugzilla.redhat.com/show_bug.cgi?id=768802) - Newline validation on leading and trailing string
+* [769471](https://bugzilla.redhat.com/show_bug.cgi?id=769471) - Variables to be checked for consistency
+* [756235](https://bugzilla.redhat.com/show_bug.cgi?id=756235) - XML and HTML tags to be checked for completeness
+* Redesign of color scheme translation editor workspace layout
+* Project/project iteration status changes: ACTIVE, READONLY, and OBSOLETE
+* Project list filtering based on status
+* Overall statistics page for Admin
+* Add file download page with the option to download a single PO file, or a zip with a project iteration's files for one locale
+* Translation memory results now have highlighted differences
+* Activate entity caching
+* Maven client option to create 'skeleton' PO files when no translations are present
+* Maven client option to log detailed client-server message information
+* Generate Zanata Rest API documentation
+* Add automated compatibility tests with previous versions of the Zanata java client classes
+* Redirect to previous page after sign in
+* Several UI updates and changes
+
+
Bug fixes
+
+* [785034](https://bugzilla.redhat.com/show_bug.cgi?id=785034) - Rapid key navigation causes backlog of TM queries
+* [750956](https://bugzilla.redhat.com/show_bug.cgi?id=750956) - Long strings slow down the operation
+* [756292](https://bugzilla.redhat.com/show_bug.cgi?id=756292) - "Participants" information is incorrect
+* [759337](https://bugzilla.redhat.com/show_bug.cgi?id=759337) - Translation editor: Long word in source cell invades the editor cell
+* [746899](https://bugzilla.redhat.com/show_bug.cgi?id=746899) - On push operations, copyTrans runs too slowly
+* [719176](https://bugzilla.redhat.com/show_bug.cgi?id=719176) - Edit profile: "duplicate email" is shown even if user press save without changing email
+* [690669](https://bugzilla.redhat.com/show_bug.cgi?id=690669) - Translation editor table shows changes which failed to save
+
+-----------------------
+
+## 1.4.5.2
+ * Fix handling of fuzzy entries when saving Properties files
+
+-----------------------
+
+## 1.4.5.1
+ * [795597](https://bugzilla.redhat.com/show_bug.cgi?id=795597) - Fix regression with Unicode encoding for ordinary (Latin-1) .properties files
+
+-----------------------
+
+## 1.4.5
+ * [742872](https://bugzilla.redhat.com/show_bug.cgi?id=742872) - Add support for Maven modules:
+ * [760431](https://bugzilla.redhat.com/show_bug.cgi?id=760431) - Fix bug: Moving to a new page does not refresh the translation textboxes (ghost translations)
+
+-----------------------
+
+## 1.4.4
+* [747836](https://bugzilla.redhat.com/show_bug.cgi?id=747836) - Ensure final reindex batch is properly flushed
+* [760390](https://bugzilla.redhat.com/show_bug.cgi?id=760390) - Support UTF-8 Properties files, handle empty properties
+* [759994](https://bugzilla.redhat.com/show_bug.cgi?id=759994) - Fix bug: Editor table stops working after 'Source and Target' search returns no results
+* Add dryRun option for Maven goals 'push' and 'pull'
+
+-----------------------
+
+## 1.4.3
+
New Features
+
+* [750690](https://bugzilla.redhat.com/show_bug.cgi?id=750690) - Show message context in editor info panel
+* [727716](https://bugzilla.redhat.com/show_bug.cgi?id=727716) - Add failsafe editor in case of Seam Text problems
+* [730189](https://bugzilla.redhat.com/show_bug.cgi?id=730189) - Change string similarity algorithm so that only identical strings (not substrings) can get 100%
+* [747836](https://bugzilla.redhat.com/show_bug.cgi?id=747836) - Show progress during re-index operations; avoid timeout for large databases
+* Update gwteventservice to 1.2.0-RC1
+* Modify email templates to include server URL
+
+
Bug fixes
+
+* [754637](https://bugzilla.redhat.com/show_bug.cgi?id=754637) - 'J' and 'K' navigation keys trigger when entering text in the TM search box
+* [756293](https://bugzilla.redhat.com/show_bug.cgi?id=756293) - Not able to work in parallel on the same workbench
+* [751264](https://bugzilla.redhat.com/show_bug.cgi?id=751264) - Fix problems with editor table when searching or switching pages
+
+-----------------------
+
+## 1.4.2
+* [742083](https://bugzilla.redhat.com/show_bug.cgi?id=742083) - Language team coordinator
+* [742854](https://bugzilla.redhat.com/show_bug.cgi?id=742854) - Contact server admins
+* [743783](https://bugzilla.redhat.com/show_bug.cgi?id=743783) - First/last entry button
+* [744114](https://bugzilla.redhat.com/show_bug.cgi?id=744114) - Load project pages faster
+* [744671](https://bugzilla.redhat.com/show_bug.cgi?id=744671) - Option for Enter to save translation
+* [746859](https://bugzilla.redhat.com/show_bug.cgi?id=746859) - Sort projects by name, not ID
+* [740122](https://bugzilla.redhat.com/show_bug.cgi?id=740122) - Make newlines visible to reduce newline mismatch errors in translations
+* [740191](https://bugzilla.redhat.com/show_bug.cgi?id=740191) - Improve shortcut keys
+* [746870](https://bugzilla.redhat.com/show_bug.cgi?id=746870) - Save as Fuzzy now leaves the cell editor open
+* [743134](https://bugzilla.redhat.com/show_bug.cgi?id=743134) - Modal navigation: next fuzzy, untranslated, fuzzy or untranslated
+* Rearrange various UI elements to be more logical (profile page, document stats, project search field)
+* Users now have to ask before joining a language team
+* Coordinator can add and remove team members
+* Contact coordinators
+* Fix tab order: editor cell -> Save as Approved -> Save as Fuzzy -> Cancel
+
+-----------------------
+
+## 1.4.1
+* [741523](https://bugzilla.redhat.com/show_bug.cgi?id=741523) - Fixed: % completed should be calculated with words, not messages
+* [724867](https://bugzilla.redhat.com/show_bug.cgi?id=724867) - Fixed: Selecting Administration submenu items does not always highlight the parent menu
+* [742111](https://bugzilla.redhat.com/show_bug.cgi?id=742111) - Fixed: Change of tile to list view on Language page, make project list sortable
+* [743179](https://bugzilla.redhat.com/show_bug.cgi?id=743179) - Performance fix for projects with 1000+ documents
+
+-----------------------
+
+## 1.4
+* add project-type to zanata.xml for generic push/pull commands
+* redirect to login from translation editor when required
+* if domain is left blank by admin, don't populate email address for new users
+* UI bug fixes
+
+-----------------------
+
+## 1.4-alpha-1
+* create generic push/pull commands, with include/exclude filters
+* add support for Java Properties and XLIFF projects
+* bug fix: mark existing translations of modified XLIFF/Properties strings as fuzzy
+* modify keyboard shortcuts in editor
+* add new Zanata logo/favicon
+* various UI improvements
+* auto-size for translation text area
+* add icons to buttons and remove text
+* add option to hide editor buttons
+* remove Clone and Save button; move Copy button to middle
+* autosave when leaving a cell
+* remove Fuzzy checkbox; add Save as Fuzzy
+* better statistics graphs
+* display resource IDs for translation units
+* add ability to hide translation unit details
+* show translation states with coloured side bars, and italics for Fuzzy
+* recalculate missing word counts
+* add liquibase script
+* bug fix for search re-indexing by admin
+* copy translations of identical strings when importing new documents
+* bug fixes and improvements for UI
+* bug fix for word counts (thread safety)
+* remove email address from Language Team pages
+* enable stats for anonymous users
+* no need to enforce locales for source documents
+* bug fix for push/merge when PO files are missing some msgids
+* bug fixes
+
+-----------------------
+
+## 1.3
+* bug fixes for authentication and for source comments
+
+-----------------------
+
+## 1.3-alpha-3
+* finalise rebrand from flies->zanata: XML namespaces, media types, etc
+* more logging for authentication errors
+* bug fix for Kerberos authentication
+
+-----------------------
+
+## 1.3-alpha-2
+* switch source control to git on github
+* rebrand from flies->zanata (maven artifacts, java packages, mailing lists)
+* Fedora authentication rhbz#692011
+* generate zanata.xml config file (http://code.google.com/p/flies/issues/detail?id=282)
+* merge translations on import (http://code.google.com/p/flies/issues/detail?id=28)
+* preserve and generate PO header comments for translator credits (http://code.google.com/p/flies/issues/detail?id=269)
+* bug fixes
+
+-----------------------
+
+## 1.3-alpha-1
+* rebrand from flies->zanata (except URIs, maven artifacts and java packages)
+* specify locales per project/version (http://code.google.com/p/flies/issues/detail?id=261)
+* added tab for home page, removed project list, contents editable by admin (http://code.google.com/p/flies/issues/detail?id=279)
+* added help page/tab, contents editable by admin (http://code.google.com/p/flies/issues/detail?id=280)
+* removed name and description from project version (http://code.google.com/p/flies/issues/detail?id=281)
+* stats for all languages (http://code.google.com/p/flies/issues/detail?id=275)
+* workaround for form/login issue on Firefox 4.0 rhbz#691963
+* bug fixes
+
+-----------------------
+
+## flies-1.2
+* disabled bad key bindings (http://code.google.com/p/flies/issues/detail?id=262)
+* fixed python client issue with PotEntryHeader.extractedComment (http://code.google.com/p/flies/issues/detail?id=256)
+* web template redesign (new logo, CSS) (http://code.google.com/p/flies/issues/detail?id=238)
+* fixed Seam integration tests (http://code.google.com/p/flies/issues/detail?id=231)
+
+-----------------------
+
+## flies-1.2-alpha-3
+* improve notifications in editor (http://code.google.com/p/flies/issues/detail?id=191)
+* highlight search terms in editor (http://code.google.com/p/flies/issues/detail?id=227)
+
+-----------------------
+
+## flies-1.2-alpha-2
+* better messages
+* bug fixes
+
+-----------------------
+
+## flies-1.2-alpha-1
+* development change: re-arranged Maven modules into common, client and server
+
+-----------------------
+
+## flies-1.1.1
+* use word counts in translation statistics (http://code.google.com/p/flies/issues/detail?id=203)
+* bug fixes
+
+-----------------------
+
+## flies-1.1
+* Kerberos/JAAS fixes
+* require name & email address on first login for JAAS/Kerberos
+* validate changes to email address
+* use correct BCP-47 language tags (zh-CN-Hans is now zh-Hans-CN)
+
+-----------------------
+
+## flies-1.1-alpha-1
+* JAAS authentication
+* Kerberos authentication
+* remove communities tab and my communities UI (http://code.google.com/p/flies/issues/detail?id=197)
+* remove "Language Missing" button (http://code.google.com/p/flies/issues/detail?id=185)
+* show member number for the language groups (http://code.google.com/p/flies/issues/detail?id=186)
+* allow overriding POT directory in Maven client (http://code.google.com/p/flies/issues/detail?id=200)
+* support `[servers]` in flies.ini for Maven client (http://code.google.com/p/flies/issues/detail?id=193)
+* better info/error messages in Maven client
+
+-----------------------
+
+## flies-1.0.3
+* fix TM caching issue (http://code.google.com/p/flies/issues/detail?id=190)
+* add 'translator' role and security rules
+* configurable URLs
+
+-----------------------
+
+## flies-1.0.2
+* minor UI fixes (http://code.google.com/p/flies/issues/detail?id=173, http://code.google.com/p/flies/issues/detail?id=176)
+* ergonomics for Maven client
+* UI for assigning project maintainers (http://code.google.com/p/flies/issues/detail?id=180)
+* better error checking in REST API (http://code.google.com/p/flies/issues/detail?id=175)
+* security rule fix (http://code.google.com/p/flies/issues/detail?id=182)
+
+-----------------------
+
+## flies-1.0.1
+* database schema fixes
+* fixes for deployment issues
+
+-----------------------
+
+## flies-1.0
+* initial release
+
diff --git a/docs/user-guide/client-command-hook.md b/docs/user-guide/client-command-hook.md
new file mode 100644
index 0000000000..eaaea4650c
--- /dev/null
+++ b/docs/user-guide/client-command-hook.md
@@ -0,0 +1,38 @@
+Custom commands can be specified in zanata.xml. Custom commands can be almost any command that can run on the command line, and can be configured to run before or after a Zanata client command. This feature was added in version 3.3.0 of the CLI client and the Maven Plugin, and cannot be used in earlier versions.
+
+To specify one or more custom commands:
+
+ 1. Add a `` element in zanata.xml within the `` element.
+ 1. For each Zanata command that will have custom commands attached, add a `` element that specifies the command as an attribute.
+ 1. For each custom command to run before a Zanata command, add a `` element with the command as its body.
+ 1. For each custom command to run after a Zanata command, add an `` element with the command as its body.
+
+For example, the following elements within the top-level element will generate a .pot file from a man page before push, clean up the generated file after push, and will generate a translated German man page after pull then remove all downloaded .po files.
+
+```xml
+
+
+
+...
+
+
+
+ po4a-gettextize -f man -m manpage.1 -p manpage.pot
+ rm -f manpage.pot
+
+
+ po4a-translate -f man -m manpage.1 -p trans/de/manpage.po -l manpage.de.1 --keep 1
+ rm -rf trans
+
+
+
+...
+
+
+```
+
+Multiple commands of the same type (i.e. "before" or "after") within a hook will be run in the order that they are specified in zanata.xml. e.g. when running pull with the above config, po4a will always run before rm. If any of these commands fails, the whole operation is aborted. e.g. when running push, if po4a fails then push and rm will not be run, and if push fails then rm will not be run.
+
+Note that some commands (such as 'cd') do not work as custom commands. The ranges of commands that work and that do not work as custom commands have not yet been thoroughly investigated.
+
+The return value of each custom command is displayed after the command is run. A return value of 0 usually indicates success, and any other number usually indicates an error. Console output from custom commands is not yet displayed or logged.
\ No newline at end of file
diff --git a/docs/user-guide/client-configuration.md b/docs/user-guide/client-configuration.md
index a004f67084..a29a5ad95d 100644
--- a/docs/user-guide/client-configuration.md
+++ b/docs/user-guide/client-configuration.md
@@ -1,5 +1,3 @@
-# Common configuration files for Flies clients
-
# Introduction
In general, Zanata clients should get their configuration from user config, project config and command line args (or similar).
@@ -84,6 +82,4 @@ URLs in project configuration should be matched against the [servers] defined in
## Command line or other mechanism (eg Maven properties)
-The client should also provide the ability to override user/project configuration values, perhaps with command line arguments or GUI options, etc.
-
-See ZanataMavenIntegration for the Maven configuration properties and example pom.xml.
\ No newline at end of file
+The client should also provide the ability to override user/project configuration values, perhaps with command line arguments or GUI options, etc.
\ No newline at end of file
diff --git a/docs/user-guide/merge-translations.md b/docs/user-guide/merge-translations.md
new file mode 100644
index 0000000000..727b19a0dc
--- /dev/null
+++ b/docs/user-guide/merge-translations.md
@@ -0,0 +1,59 @@
+# Merge translations from another project version
+
+Merge translations allows project maintainers to copy translations across different project version based on matching context. (See below for context matching rules)
+
+## Restrictions
+
+- This feature is only available to project maintainers.
+- Only translations that are in translated/approved state will be used.
+- Merge translation can only be run if there are no other copy operations in progress for the selected version, such as copy-trans or copy version.
+
+## Rule of which translations will be copied over
+
+
+
**From**
**To**
**Copy?**
+
+
+
fuzzy/untranslated
any
No
+
+
+
different source text/document id/ resId/msgctxt/locale
any
No
+
+
+
translated/approved
untranslated/fuzzy
Yes
+
+
+
translated/approved
translated/approved
copy if `From` is newer and `Keep existing translated/approved translations` is unchecked