--- /dev/null
+ ------
+ Using sorting of received data
+ ------
+ Dmitry Samoshin aka gotty
+ ------
+ 2017-01-27
+ ------
+
+~~ Copyright (c) 2017. Developed by Hedgecode.
+~~
+~~ Licensed under the Apache License, Version 2.0 (the "License");
+~~ you may not use this file except in compliance with the License.
+~~ You may obtain a copy of the License at
+~~
+~~ http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing, software
+~~ distributed under the License is distributed on an "AS IS" BASIS,
+~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+~~ See the License for the specific language governing permissions and
+~~ limitations under the License.
+
+~~ NOTE: For help with the syntax of this file, see:
+~~ http://maven.apache.org/doxia/references/apt-format.html
+
+Using sorting of received data
+
+ The data obtained from the API methods calls of the main interface of the library,
+ in most cases, represent collection classes (<<<Players>>>, <<<Events>>>, <<<Matches>>>)
+ which can be sorted by certain parameters for convenience of further use in client applications.
+
+ The types of possible sorts for specific collection classes are listed below.
+
+===
+
+ <<<Players>>> - entity class which contains a selection of players on certain parameters.\
+ This class provides two types of sorting:
+
+ <<1.>> Sorting players by name.
+
+ <<2.>> Sorting players by age, both in descending order and in ascending order.
+
+ Java code that shows all the above sorting methods is presented below:
+
++-------
+Players players = Snooker.API().getPlayers(...);
+...
+players.sortByName();
+...
+players.sortByAge();
+players.sortByAgeDesc();
+...
++-------
+
+===
+
+ <<<Events>>> - entity class which contains a selection of tournaments for certain parameters.
+
+ Java code that shows the sorting of tournaments by date is presented below:
+
++-------
+Events events = Snooker.API().getSeasonEvents((...);
+...
+events.sortByDate();
+...
++-------
+
+===
+
+ <<<Matches>>> - entity class which contains a selection of matches for certain parameters.\
+ This class provides two types of sorting:
+
+ <<1.>> Sorting matches by number.\
+ This sorting type will be useful when the selection contains all the matches of a single tournament.
+
+ <<2.>> Sorting matches by tournament.\
+ This sorting type will be useful when the selection contains all the matches
+ of an individual player for the season in different tournaments.
+
+ Java code that shows all the above sorting methods is presented below:
+
++-------
+Matches matches = Snooker.API().getEventMatches((...);
+...
+matches.sortByNumber();
+...
+matches.sortByEvent();
+...
++-------