\nNaposledy jsem psal o čuňačení v MediaWiki asi před půl rokem, kdy jsem chtěl upozornit na to, že jsem přepracoval svoji původní šablonu Images tak, aby bylo možné používat výřezy z obrázků a stránek generovaných z DjVu a PDF dokumentů. Blogpost nebyl nijak extra hodnocen, takže mě vcelku nepřekvapuje, jak se do hlavní vývojové větve MediaWiki dostávají čím dál větší prasečiny.\n
","feed_id":"5903","feed_title":"abclinuxu - blogy","flavor_image":"","flavor_stream":"","guid":"{\"ver\":2,\"uid\":\"52\",\"hash\":\"SHA1:5b49e4d8f612984889ba25e7834e80604c795ff8\"}","id":6958843,"is_updated":false,"labels":[],"lang":"","link":"http://www.abclinuxu.cz/blog/kenyho_stesky/2021/1/cunacime-v-mediawiki-responzivni-obsah-ii","marked":false,"note":null,"published":false,"score":0,"tags":[""],"title":"Čuňačíme v MediaWiki - responzivní obsah II.","unread":true,"updated":1610044674}
+time=" 34.361" type="debug" -> feed-downloader: Running filter script, it took 348 microseconds.
+time=" 34.361" type="debug" -> feed-downloader: Hooking message took 4 microseconds.
+time=" 34.361" type="debug" -> {"always_display_attachments":false,"attachments":[],"author":"kol-ouch","comments_count":0,"comments_link":"","content":"Ahoj, 1. 6. se blíží, tak začínám řešit co s bambilionem fotek na google photos. \n\s*Ads[\S\s]+Remove<\/a>[\S\s]+adv\/www\/delivery[\S\s]+?<\/div>/im, '');
+
+ return MessageObject.Accept;
+}
+```
\ No newline at end of file
diff --git a/docs/source/features/gui-concepts.md b/docs/source/features/gui-concepts.md
new file mode 100644
index 000000000..8841a839b
--- /dev/null
+++ b/docs/source/features/gui-concepts.md
@@ -0,0 +1,27 @@
+General GUI Concepts & Manipulating Accounts & Adding Feeds
+===========================================================
+Feed list displays all your feeds and other items such as recycle bin.
+
+Article list displays all your articles depending on what is selected in feed list.
+
+Article preview displays details of selected article or information about selected item from feed list if no article is selected.
+
+Titlebar of RSS Guard display number of unread articles in square brackets.
+
+There are two toolbars available, separate toolbar for feed list and for article list.
+
+----
+
+When you start RSS Guard for the very first time, you are greeted with `Add account` dialog where you select which account you want to operate with. If you want to have classic `RSS/ATOM` feed reader, then select `RSS/RDF/ATOM/JSON` option.
+
+

+
+Each "account" offers account-specific actions which are accessible in relevant submenu.
+
+

+
+To add new feed into the account you simply use `Feeds -> Add item -> Add a new feed` menu item.
+
+

+
+In 99% of cases, you only need to insert feed URL into `Source` field and then hit `Fetch it now` button which will download feed metadata and fill all other boxes.
\ No newline at end of file
diff --git a/docs/source/features/images/account-menu.png b/docs/source/features/images/account-menu.png
new file mode 100644
index 000000000..6071cbcea
Binary files /dev/null and b/docs/source/features/images/account-menu.png differ
diff --git a/docs/source/features/images/accounts.png b/docs/source/features/images/accounts.png
new file mode 100644
index 000000000..e9e4522ad
Binary files /dev/null and b/docs/source/features/images/accounts.png differ
diff --git a/docs/source/features/images/feed-details.png b/docs/source/features/images/feed-details.png
new file mode 100644
index 000000000..d6a2cda95
Binary files /dev/null and b/docs/source/features/images/feed-details.png differ
diff --git a/docs/source/features/images/filters-dialog.png b/docs/source/features/images/filters-dialog.png
new file mode 100644
index 000000000..55cb8d97d
Binary files /dev/null and b/docs/source/features/images/filters-dialog.png differ
diff --git a/docs/source/features/images/rssguard-window.png b/docs/source/features/images/rssguard-window.png
new file mode 100644
index 000000000..42d858ef5
Binary files /dev/null and b/docs/source/features/images/rssguard-window.png differ
diff --git a/docs/source/index.rst b/docs/source/index.rst
index a27b43e4d..8ba7cf585 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -1,8 +1,8 @@
RSS Guards documentation!
-=====================================
+=========================
.. toctree::
- :maxdepth: 2
+ :maxdepth: 1
what
donations
@@ -10,8 +10,16 @@ RSS Guards documentation!
supported-os
supported-readers
+.. toctree::
+ :maxdepth: 1
+ :caption: Features
+ :glob:
+
+ features/gui-concepts
+ features/*
+
Indices and tables
-==================
+------------------
* :ref:`genindex`
* :ref:`modindex`
diff --git a/docs/source/requirements.txt b/docs/source/requirements.txt
index 787720e65..0bc2820eb 100644
--- a/docs/source/requirements.txt
+++ b/docs/source/requirements.txt
@@ -1,2 +1,3 @@
myst_parser
+linkify-it-py
sphinx-rtd-theme
\ No newline at end of file
diff --git a/docs/source/supported-os.md b/docs/source/supported-os.md
new file mode 100644
index 000000000..0241b5849
--- /dev/null
+++ b/docs/source/supported-os.md
@@ -0,0 +1,8 @@
+Supported Operating Systems
+===========================
+RSS Guard is a cross-platform application, and at this point it is known to work on:
+* Windows 7+
+* GNU/Linux (including PinePhone and other Linux-based phone operating systems)
+* BSD (FreeBSD, OpenBSD, NetBSD, etc.)
+* macOS 10.14+
+* OS/2 (ArcaOS, eComStation)
\ No newline at end of file
diff --git a/docs/source/supported-os.rst b/docs/source/supported-os.rst
deleted file mode 100644
index 424be3d63..000000000
--- a/docs/source/supported-os.rst
+++ /dev/null
@@ -1,9 +0,0 @@
-Supported Operating Systems
-===========================
-
-RSS Guard is a cross-platform application, and at this point it is known to work on:
- * Windows 7+
- * GNU/Linux (including PinePhone and other Linux-based phone operating systems)
- * BSD (FreeBSD, OpenBSD, NetBSD, etc.)
- * macOS 10.14+
- * OS/2 (ArcaOS, eComStation)
\ No newline at end of file
diff --git a/docs/source/supported-readers.md b/docs/source/supported-readers.md
new file mode 100644
index 000000000..56514d640
--- /dev/null
+++ b/docs/source/supported-readers.md
@@ -0,0 +1,29 @@
+Supported Feed Readers
+======================
+RSS Guard is multi-account application and supports many web-based feed readers via built-in plugins. One of the plugins, of course, provides the support for standard list of **RSS/ATOM/JSON** feeds with the set of features everyone would expect from classic feed reader.
+
+I organized the supported web-based feed readers into an elegant table:
+
+| Service | Two-way Synchronization | Intelligent Synchronization Algorithm (ISA)
1 | Synchronized Labels
2 | OAuth
4 |
+| :--- | :---: | :---: | :---: | :---:
+| Feedly | ✅ | ✅ | ✅ | ✅ (only for official binaries)
+| Gmail | ✅ | ✅ | ✅ | ✅
+| Google Reader API
3 | ✅ | ✅ | ✅ | ✅ (only for Inoreader)
+| Nextcloud News | ✅ | ❌ | ❌ | ❌
+| Tiny Tiny RSS | ✅ | ✅ | ✅ | ❌
+
+
1 Some plugins support next-gen intelligent synchronization algorithm (ISA) which has some benefits, as it usually offers superior synchronization speed, and transfers much less data over your network connection.
+
+With ISA, RSS Guard only downloads articles which are new or were updated by remote server. The old algorithm usually always fetches all available articles, even if they are not needed, which leads to unnecessary overload of your network connection and the RSS Guard.
+
+
2 Note that labels are supported for all plugins, but for some plugins they are local-only, and are not synchronized with the service. Usually because service itself does not support the feature.
+
+
3 Tested services are:
+* Bazqux
+* FreshRSS
+* Inoreader
+* Miniflux
+* Reedah
+* TheOldReader
+
+
4 [OAuth](https://en.wikipedia.org/wiki/OAuth) is a secure way of authenticating users in online applications.
\ No newline at end of file
diff --git a/docs/source/supported-readers.rst b/docs/source/supported-readers.rst
deleted file mode 100644
index 20056ac07..000000000
--- a/docs/source/supported-readers.rst
+++ /dev/null
@@ -1,32 +0,0 @@
-Supported Feed Readers
-======================
-
-RSS Guard is multi-account application and supports many web-based feed readers via built-in plugins. One of the plugins, of course, provides the support for standard list of **RSS/ATOM/JSON** feeds with the set of features everyone would expect from classic feed reader.
-
-I organized the supported web-based feed readers into an elegant table:
-
-+-------------------+-------------------------+---------------------------------------+---------------------+-------+
-| Service | Two-way Synchronization | Intelligent Synchronization Algorithm | Synchronized Labels | OAuth |
-+===================+=========================+=======================================+=====================+=======+
-| Feedly | ✅ | ✅ | ✅ | ✅ |
-+-------------------+-------------------------+---------------------------------------+---------------------+-------+
-| Gmail | ✅ | ✅ | ✅ | ✅ |
-+-------------------+-------------------------+---------------------------------------+---------------------+-------+
-| Google Reader API | ✅ | ✅ | ✅ | ✅ |
-+-------------------+-------------------------+---------------------------------------+---------------------+-------+
-| Nextcloud News | ✅ | ❌ | ❌ | ❌ |
-+-------------------+-------------------------+---------------------------------------+---------------------+-------+
-| Tiny Tiny RSS | ✅ | ✅ | ✅ | ❌ |
-+-------------------+-------------------------+---------------------------------------+---------------------+-------+
-
-:superscript:`1` Some plugins support next-gen intelligent synchronization algorithm which has some benefits, as it usually offers superior synchronization speed, and transfers much less data over your network connection. RSS Guard only downloads articles which are new or were updated by remote server. The old algorithm usually always fetches all available articles, even if they are not needed, which leads to unnecessary overload of your network connection and the RSS Guard.
-
-:superscript:`2` Note that labels are supported for all plugins, but for some plugins they are local-only, and are not synchronized with the service. Usually because service itself does not support the feature.
-
-:superscript:`3` Tested services are:
- * Bazqux
- * FreshRSS
- * Inoreader
- * Miniflux
- * Reedah
- * TheOldReader
\ No newline at end of file
diff --git a/docs/source/what.md b/docs/source/what.md
new file mode 100644
index 000000000..e88d4eb88
--- /dev/null
+++ b/docs/source/what.md
@@ -0,0 +1,3 @@
+What is RSS Guard?
+==================
+RSS Guard is an [open-source](https://en.wikipedia.org/wiki/Open_source) cross-platform multi-protocol desktop feed reader. It is able to fetch feeds in RSS/RDF/ATOM/JSON formats and connect to multiple web-based feed readers. RSS Guard is developed on top of the [Qt library](http://qt-project.org).
\ No newline at end of file
diff --git a/docs/source/what.rst b/docs/source/what.rst
deleted file mode 100644
index 2618e6479..000000000
--- a/docs/source/what.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-:tocdepth: 2
-
-What is RSS Guard?
-==================
-
-RSS Guard is an `open-source
`_ cross-platform multi-protocol desktop feed reader. It is able to fetch feeds in RSS/RDF/ATOM/JSON formats and connect to multiple web-based feed readers. RSS Guard is developed on top of the `Qt library `_.
\ No newline at end of file