documentation update

Author: ddmitov

CREDITS.md

@@ -35,7 +35,7 @@ https://metacpan.org/pod/File::Copy::Recursive
 Thanks to [probonopd](https://github.com/probonopd) for his  
 knowledgeable instructions and patient cooperation  
 in the preparation and testing of Perl Executing Browser AppImages.  
-His tool [linuxdeployqt](https://github.com/probonopd) is used to generate all released AppImages.  
+His tool [linuxdeployqt](https://github.com/probonopd/linuxdeployqt) is used to generate all released AppImages.  
 The [AppImageHub page of Perl Executing Browser](https://appimage.github.io/perl-executing-browser/) wouldn't be created without his assistance.  
 
 ## Qt
@@ -253,10 +253,10 @@ https://ryanstutorials.net/bash-scripting-tutorial/bash-functions.php
 
 ## AppImage
 
-https://www.freedesktop.org/software/appstream/docs/chap-Quickstart.html  
-https://specifications.freedesktop.org/desktop-entry-spec/1.1/apa.html  
+https://standards.freedesktop.org/menu-spec/latest/apa.html  
 https://github.com/probonopd/linuxdeployqt  
 http://output.jsbin.com/qoqukof  
+https://unix.stackexchange.com/questions/156892/how-to-validate-verify-desktop-files  
 
 ## Docker Containers
 

README.md

@@ -2,8 +2,7 @@
 
 [![GitHub Version](https://img.shields.io/github/release/ddmitov/perl-executing-browser.svg)](https://github.com/ddmitov/perl-executing-browser/releases)
 [![GitHub License](http://img.shields.io/badge/License-LGPL%20v3-blue.svg)](./LICENSE.md)
-[![Travis CI Build Status](https://travis-ci.org/ddmitov/perl-executing-browser.svg?branch=master)](https://travis-ci.org/ddmitov/perl-executing-browser)
-[![Coverity Scan Build Status](https://scan.coverity.com/projects/11334/badge.svg)](https://scan.coverity.com/projects/ddmitov-perl-executing-browser)  
+[![Travis CI Build Status](https://travis-ci.org/ddmitov/perl-executing-browser.svg?branch=master)](https://travis-ci.org/ddmitov/perl-executing-browser)  
 
 Perl Executing Browser (PEB) is an HTML5 user interface for [Perl 5](https://www.perl.org/) desktop applications. By default it runs local Perl 5 scripts as child processes with no server and is implemented as a C++ executable based on the [Qt 5](https://www.qt.io/) libraries. Inspired by [Electron](http://electron.atom.io/) and [NW.js](http://nwjs.io/), PEB is another reuse of web technologies in desktop applications with Perl doing the heavy lifting instead of [Node.js](https://nodejs.org/en/).
 

doc/PACKAGING.md

@@ -34,6 +34,23 @@ Perl Distribution Compactor depends on [Module::ScanDeps](https://metacpan.org/p
 
   The PEB AppImage Maker script must be started from the ``{PEB_executable_directory}/sdk`` directory.  
 
+* **PEB AppImage Configuration Files**
+
+  ``{PEB_executable_directory}/resources/app/{application_name}.desktop``  
+  ``{PEB_executable_directory}/resources/app/{application_name}.appdata.xml``  
+
+  ``{PEB_executable_directory}/resources/app/{application_name}.desktop``  
+  is mandatory for any PEB-based application, that is going to be packed as an AppImage using the PEB AppImage Maker. A minimal example of ``{application_name}.desktop`` is available [here](https://github.com/ddmitov/perl-executing-browser/blob/master/resources/app/peb-demo.desktop).  
+  ``Icon=app`` inside ``{application_name}.desktop`` must not be changed for the proper display of the application icon.  
+  All registered categories in an ``{application_name}.desktop`` are available [here](https://standards.freedesktop.org/menu-spec/latest/apa.html).  
+  Any ``{application_name}.desktop`` file can be validated using the ``desktop-file-validate`` tool from the  ``desktop-file-utils`` package in all major Linux distributions.  
+
+  The [AppStream Generator](http://output.jsbin.com/qoqukof) of [probonopd](https://github.com/probonopd) is the recommended tool for generating AppStream (.appdata.xml) files for PEB-based applications.  
+  An example of ``{aplication_name}.appdata.xml`` is available [here](https://github.com/ddmitov/perl-executing-browser/blob/master/resources/app/peb-demo.appdata.xml).  
+  ``{application_name}.appdata.xml`` is not mandatory, but is highly recommended.  
+
+  Both PEB AppImage configuration files are copied on their proper places in the AppImage directory tree structure by the PEB AppImage Maker script.  
+
 * **PEB AppImage Builder Docker Container**
 
   An easy building environment for PEB AppImage executables is the provided [PEB AppImage Builder Docker Container](https://github.com/ddmitov/perl-executing-browser/blob/master/sdk/Dockerfile).  

resources/app/peb-demo.appdata.xml

@@ -6,7 +6,7 @@
   <name>PEB Demo</name>
   <summary>Perl Executing Browser Demo Package</summary>
   <description>
-    <p>Perl Executing Browser (PEB) is an HTML5 user interface for Perl 5 desktop applications. By default it runs local Perl 5 scripts as child processes with no server and is implemented as a C++ executable based on the Qt 5 libraries. Inspired by Electron and NW.js, PEB is another reuse of web technologies in desktop applications with Perl doing the heavy lifting instead of Node.js.</p>
+    <p>Perl Executing Browser is an HTML interface for Perl 5 desktop applications.</p>
   </description>
   <launchable type="desktop-id">peb.desktop</launchable>
   <url type="homepage">https://github.com/ddmitov/perl-executing-browser</url>