Merge branch 'master' into dev

CONTRIBUTING.md

@@ -9,3 +9,6 @@ Make sure library part (libsrc/ffdec_lib) does not depend on GUI and does not co
 
 ## Tests
 Make sure existing tests pass.
+
+## Translations to other languages
+For information about localizations to other languages and how to contribute, see [TRANSLATIONS.md](TRANSLATIONS.md) file

README.md

@@ -3,18 +3,17 @@
 Opensource flash SWF decompiler and editor. Extract resources, convert SWF to FLA, edit ActionScript, replace images, sounds, texts or fonts. Various output formats available. Works with Java on Windows, Linux or MacOS.
 
 ## Application description and features
-For information how to install, use the software, list of features, etc., visit [FFDec Wiki](https://github.com/jindrapetrik/jpexs-decompiler/wiki/).
+For information about using the software, list of features, etc., visit [FFDec Wiki](https://github.com/jindrapetrik/jpexs-decompiler/wiki/).
 
 ## Free-Decompiler.com website
 In the past (before 2018), we were using *free-decompiler.com* domain as HomePage, GitHub for source code, now we moved all information to Github.
 
 ## Download application
-Fow downloading the app, see [releases section](https://github.com/jindrapetrik/jpexs-decompiler/releases)
+For downloading the app, see [latest release](https://github.com/jindrapetrik/jpexs-decompiler/releases/latest).
+Older versions and nightly builds are availabe on [releases section](https://github.com/jindrapetrik/jpexs-decompiler/releases)
 
-## Issue tracker
-For bug reporting and/or feature requests, our own Issue tracker exists :
-[https://www.free-decompiler.com/flash/issues](https://www.free-decompiler.com/flash/issues),
-but as of 2018/01, our support is *very limited*.
+### How to install
+See [installation section of wiki](https://github.com/jindrapetrik/jpexs-decompiler/wiki/Installation)
 
 ## Source code
 ### How to get source
@@ -129,6 +128,17 @@ The application was made in Czech republic.
 * **realmaster42** - portugese-brasil translation
 * **Rtsjx** - chinese translation
 
+## Contact
+### Issue Tracker
+For bug reporting and/or feature requests, our own Issue tracker exists :
+[https://www.free-decompiler.com/flash/issues](https://www.free-decompiler.com/flash/issues),
+but as of 2018/01, our support is *very limited*.
+
+### Email contact
+**Please contact us via Issue Tracker (see above)**
+
+In case the tracker or *free-decompiler.com* domain is down,
+emergency contact to JPEXS developer is `jindra.petrik@gmail.com`.
 
 ## Licenses + Acknowledgments
 ### Application

TRANSLATIONS.md

@@ -0,0 +1,44 @@
+# Translations
+
+## Available languages
+ FFDec contains these translations:
+ - English
+ - Catalan
+ - Czech
+ - Chinese
+ - Dutch
+ - French
+ - German
+ - Hungarian
+ - Italian
+ - Polish
+ - Portugese - Portugal
+ - Portugese - Brasilian
+ - Russian
+ - Spanish
+ - Swedish
+ - Ukrainian
+
+## Preparing...
+Translators are working on these new translations: 
+- Turkish
+
+## New translation
+If you would like to translate FFDec to your language, please follow these steps:
+
+1. Check whether your language is not already present or in preparing state (see list on the top)
+2. Find out your language code (See [table](http://www.loc.gov/standards/iso639-2/php/code_list.php) )
+3. Create new issue in [issue tracker](https://www.free-decompiler.com/flash/issues/) containing your new language name + code. (You should register first)
+4. Download `Language pack for translators (zipped)` from latest (including nighlty) version on [releases page](https://github.com/jindrapetrik/jpexs-decompiler/releases)
+5. The archive contains all language files for newest version of FFDec. Each language in this pack has files with its own suffix which is standard language code.
+6. Extract Language pack ZIP file
+7. Copy each `.properties` file without `_xx` suffix (english), to new file which has your language code suffix (`_cs` is for czech, etc...)
+8. Open `.properties` files with an editor. (`.properties` editor bundled with some Java IDE is better than standard text editor)
+9. In order to `.properties` to work in FFDec, all nonascii characters should be replaced with unicode escapes (like `\u1234`). IDE editors like Netbeans do this automatically. If you have classic text editor, you can skip this phase, I will do it later myself.
+10. Don't forget to place your name in `AboutDialog_xx.properties` file.
+11. Attach translated files to that issue.
+12. Goto [Issue #354] and look for new translated strings.
+12. Subscribe to [Issue #354] to be notified about new strings in the future.
+13. Wait for next release where your translation will be included.
+
+[Issue #354]: https://www.free-decompiler.com/flash/issues/354-new-translations