From 18e392bad9749e55f2fecba2b8a030e98674d3c1 Mon Sep 17 00:00:00 2001
From: nodiscc <nodiscc@gmail.com>
Date: Mon, 4 Sep 2023 14:05:16 +0200
Subject: [PATCH 01/12] add description for code review section

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index beef432..352e6e0 100644
--- a/README.md
+++ b/README.md
@@ -180,6 +180,8 @@ _Related: [IT Asset Management](#it-asset-management)_
 
 **[`^        back to top        ^`](#awesome-sysadmin)**
 
+[Code review](https://en.wikipedia.org/wiki/Code_review) is a software quality assurance activity in which one or several people check a program mainly by viewing and reading parts of its source code.
+
 **Please visit [awesome-selfhosted/Software Development - Project Management](https://github.com/awesome-selfhosted/awesome-selfhosted#software-development---project-management)**
 
 

From 21514b1380a5d040f58e1954d904fdef0d05cf28 Mon Sep 17 00:00:00 2001
From: nodiscc <nodiscc@gmail.com>
Date: Mon, 4 Sep 2023 14:07:17 +0200
Subject: [PATCH 02/12] redirect identity management section to specialized
 subsections

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index 352e6e0..03394ed 100644
--- a/README.md
+++ b/README.md
@@ -383,6 +383,8 @@ Open-source code editors.
 
 LDAP servers and other tools to manage accounts and identities.
 
+**Please visit [Identity Management - LDAP](#identity-management---ldap), [Identity Management - Tools and web interfaces](#identity-management---tools-and-web-interfaces), [Identity Management - Single Sign-On SSO](#identity-management---single-sign-on-sso)**
+
 
 ### Identity Management - LDAP
 

From be7eafdea6bed01e69069d59d86a62894449d5a5 Mon Sep 17 00:00:00 2001
From: nodiscc <nodiscc@gmail.com>
Date: Mon, 4 Sep 2023 14:08:18 +0200
Subject: [PATCH 03/12] add description for identity management section

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 03394ed..d82927c 100644
--- a/README.md
+++ b/README.md
@@ -381,7 +381,7 @@ Open-source code editors.
 
 **[`^        back to top        ^`](#awesome-sysadmin)**
 
-LDAP servers and other tools to manage accounts and identities.
+[Identity management](https://en.wikipedia.org/wiki/Identity_management) (IdM), also known as identity and access management (IAM or IdAM), is a framework of policies and technologies to ensure that the right users (that are part of the ecosystem connected to or within an enterprise) have the appropriate access to technology resources.
 
 **Please visit [Identity Management - LDAP](#identity-management---ldap), [Identity Management - Tools and web interfaces](#identity-management---tools-and-web-interfaces), [Identity Management - Single Sign-On SSO](#identity-management---single-sign-on-sso)**
 

From f37ca3499896e737a291f2348164ff7f7a4423c9 Mon Sep 17 00:00:00 2001
From: nodiscc <nodiscc@gmail.com>
Date: Mon, 4 Sep 2023 14:09:12 +0200
Subject: [PATCH 04/12] add description for mail clients section

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index d82927c..bef3561 100644
--- a/README.md
+++ b/README.md
@@ -454,6 +454,8 @@ Log management tools: collect, parse, visualize...
 
 **[`^        back to top        ^`](#awesome-sysadmin)**
 
+An [email client](https://en.wikipedia.org/wiki/Email_client), email reader or, more formally, message user agent (MUA) or mail user agent is a computer program used to access and manage a user's email. 
+
 - [Claws Mail](http://www.claws-mail.org/) - Old school email client (and news reader), based on GTK+. ([Source Code](https://git.claws-mail.org/?p=claws.git;a=tree)) `GPL-3.0` `C`
 - [ImapSync](http://imapsync.lamiral.info/) - Simple IMAP migration tool for copying mailboxes to other servers. ([Source Code](https://github.com/imapsync/imapsync)) `NLPL` `Perl`
 - [Mutt](http://www.mutt.org/) - Small but very powerful text-based mail client. ([Source Code](https://gitlab.com/muttmua/mutt)) `GPL-2.0` `C`

From 1a37e188f0a2782ae11759a3e227d1d87d4d1ce6 Mon Sep 17 00:00:00 2001
From: nodiscc <nodiscc@gmail.com>
Date: Mon, 4 Sep 2023 14:10:30 +0200
Subject: [PATCH 05/12] remove OMD (discontinued) - continued through CheckMK
 and OMD Labs-Edition (https://labs.consol.de/omd/)

---
 README.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/README.md b/README.md
index bef3561..1748cc3 100644
--- a/README.md
+++ b/README.md
@@ -493,7 +493,6 @@ _Related: [Metrics & Metric Collection](#metrics--metric-collection)_
 - [Netdata](https://www.netdata.cloud/) - Distributed, real-time, performance and health monitoring for systems and applications. Runs on Linux, FreeBSD, and MacOS. ([Source Code](https://github.com/netdata/netdata)) `GPL-3.0` `C`
 - [NetXMS](https://www.netxms.org/) - Open Source network and infrastructure monitoring and management. ([Source Code](https://github.com/netxms/netxms)) `LGPL-3.0/GPL-3.0` `Java/C++/C`
 - [Observium Community Edition](http://www.observium.org/) - Network monitoring and management platform that provides real-time insight into network health and performance. `QPL-1.0` `PHP`
-- [OMD](http://omdistro.org/) - The Open Monitoring Distribution.
 - [Performance Co-Pilot](http://pcp.io) - Lightweight, distributed system performance and analysis framework. ([Source Code](https://github.com/performancecopilot/pcp)) `LGPL-2.1/GPL-2.0` `C`
 - [PHP Server Monitor](https://www.phpservermonitor.org/) - Open source tool to monitor your servers and websites. ([Source Code](https://github.com/phpservermon/phpservermon)) `GPL-3.0` `PHP`
 - [PhpSysInfo](https://phpsysinfo.github.io/phpsysinfo/) - A customizable PHP script that displays information about your system nicely. ([Source Code](https://github.com/phpsysinfo/phpsysinfo)) `GPL-2.0` `PHP`

From 610c16bc92c0f31703f31495ae006f704071da6d Mon Sep 17 00:00:00 2001
From: nodiscc <nodiscc@gmail.com>
Date: Mon, 4 Sep 2023 14:11:35 +0200
Subject: [PATCH 06/12] add description for status pages section - copied from
 https://github.com/awesome-selfhosted/awesome-selfhosted#status--uptime-pages

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index 1748cc3..0e1ed4a 100644
--- a/README.md
+++ b/README.md
@@ -511,6 +511,8 @@ _Related: [Metrics & Metric Collection](#metrics--metric-collection)_
 
 **[`^        back to top        ^`](#awesome-sysadmin)**
 
+[Uptime](https://en.wikipedia.org/wiki/Uptime) is a measure of system reliability, expressed as the percentage of time a machine, typically a computer, has been working and available.
+
 **Please visit [awesome-selfhosted/Status / Uptime Pages](https://github.com/awesome-selfhosted/awesome-selfhosted#status--uptime-pages)**
 
 

From 0ffd8c6e1d91f65318599ca4298b9f9a0024e72e Mon Sep 17 00:00:00 2001
From: nodiscc <nodiscc@gmail.com>
Date: Mon, 4 Sep 2023 14:12:56 +0200
Subject: [PATCH 07/12] add description for packaging section

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index 0e1ed4a..27378ac 100644
--- a/README.md
+++ b/README.md
@@ -564,6 +564,8 @@ Newsletter software.
 
 **[`^        back to top        ^`](#awesome-sysadmin)**
 
+A [package manager](https://en.wikipedia.org/wiki/Package_manager) or package-management system is a collection of software tools that automates the process of installing, upgrading, configuring, and removing computer programs for a computer in a consistent manner.
+
 - [aptly](https://www.aptly.info/) - Swiss army knife for Debian repository management. ([Source Code](https://github.com/aptly-dev/aptly)) `MIT` `Go`
 - [fpm](https://fpm.readthedocs.io/en/latest/) - Versatile multi format package creator. ([Source Code](https://github.com/jordansissel/fpm)) `MIT` `Ruby`
 - [omnibus-ruby](https://github.com/chef/omnibus) - Easily create full-stack installers for your project across a variety of platforms. `Apache-2.0` `Ruby`

From d6ef9701f32f1011ccdbf54320a6d08fcd5bce6d Mon Sep 17 00:00:00 2001
From: nodiscc <nodiscc@gmail.com>
Date: Mon, 4 Sep 2023 14:15:21 +0200
Subject: [PATCH 08/12] add descriptino for queuing section

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index 27378ac..0ea3796 100644
--- a/README.md
+++ b/README.md
@@ -585,6 +585,8 @@ Web-based project management and bug tracking systems.
 
 **[`^        back to top        ^`](#awesome-sysadmin)**
 
+[Message queues](https://en.wikipedia.org/wiki/Message_queue) and [message broker](https://en.wikipedia.org/wiki/Message_broker) software, typically used for inter-process communication (IPC), or for inter-thread communication within the same process.
+
 - [ActiveMQ](https://activemq.apache.org/) - Java message broker. ([Source Code](https://github.com/apache/activemq)) `Apache-2.0` `Java`
 - [BeanstalkD](https://beanstalkd.github.io/) - A simple, fast work queue. ([Source Code](https://github.com/beanstalkd/beanstalkd)) `MIT` `C`
 - [Gearman](http://gearman.org/) - Fast multi-language queuing/job processing platform. ([Source Code](https://github.com/gearman/gearmand)) `BSD-3-Clause` `C++`

From 98863d41e15d4943606b8f4ed15856725227d7e9 Mon Sep 17 00:00:00 2001
From: nodiscc <nodiscc@gmail.com>
Date: Mon, 4 Sep 2023 14:17:03 +0200
Subject: [PATCH 09/12] add description for router section - fix subversion and
 SoftEther entries syntax

---
 README.md | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 0ea3796..9da0aac 100644
--- a/README.md
+++ b/README.md
@@ -598,12 +598,12 @@ Web-based project management and bug tracking systems.
 
 ### Remote Desktop Clients
 
+**[`^        back to top        ^`](#awesome-sysadmin)**
+
 [Remote Desktop](https://en.wikipedia.org/wiki/Remote_desktop_software) client software.
 
 _See also: [awesome-selfhosted/Remote Access](https://github.com/awesome-selfhosted/awesome-selfhosted#remote-access)_
 
-**[`^        back to top        ^`](#awesome-sysadmin)**
-
 - [Remmina](https://www.remmina.org/) - Feature-rich remote desktop application for linux and other unixes. ([Source Code](https://gitlab.com/Remmina/Remmina)) `GPL-2.0` `C`
 - [Tiger VNC](https://tigervnc.org/) - High-performance, multi-platform VNC client and server. ([Source Code](https://github.com/TigerVNC/tigervnc)) `GPL-2.0` `C++`
 - [X2go](https://wiki.x2go.org/doku.php) - X2Go is an open source remote desktop software for Linux that uses the NoMachine/NX technology protocol. ([Source Code](https://code.x2go.org/gitweb)) `GPL-2.0` `Perl`
@@ -611,6 +611,10 @@ _See also: [awesome-selfhosted/Remote Access](https://github.com/awesome-selfhos
 
 ### Router
 
+**[`^        back to top        ^`](#awesome-sysadmin)**
+
+Software for management of [router](https://en.wikipedia.org/wiki/Router_(computing)) hardware.
+
 - [DD-WRT](https://dd-wrt.com/) - A Linux-based firmware for wireless routers and access points, originally designed for the Linksys WRT54G series. ([Source Code](https://svn.dd-wrt.com/)) `GPL-2.0` `C` 
 - [OpenWrt](https://openwrt.org/) - A Linux-based router featuring Mesh networking, IPS via snort and AQM among many other features. ([Source Code](https://git.openwrt.org/openwrt/openwrt.git)) `GPL-2.0` `C`
 - [OPNsense](https://opnsense.org/) - An open source FreeBSD-based firewall and router with traffic shaping, load balancing, and virtual private network capabilities. ([Source Code](https://github.com/opnsense)) `BSD-2-Clause` `C` `PHP`
@@ -669,7 +673,7 @@ Software versioning and revision control.
 - [Fossil](https://www.fossil-scm.org/) - Distributed version control with built-in wiki and bug tracking. ([Source Code](https://www.fossil-scm.org/home/dir?ci=trunk)) `BSD-2-Clause` `C`
 - [Git](https://git-scm.com/) - Distributed revision control and source code management (SCM) with an emphasis on speed. ([Source Code](https://github.com/git/git)) `GPL-2.0` `C`
 - [Mercurial](https://www.mercurial-scm.org/) - Distributed source control management tool. ([Source Code](https://repo.mercurial-scm.org/hg/file/tip)) `GPL-2.0` `Python/C/Rust`
-- [Subversion](https://subversion.apache.org/) - Client-server revision control system.([Source Code](https://svn.apache.org/repos/asf/subversion/trunk/)) `Apache-2.0` `C`
+- [Subversion](https://subversion.apache.org/) - Client-server revision control system. ([Source Code](https://svn.apache.org/repos/asf/subversion/trunk/)) `Apache-2.0` `C`
 
 
 ### Virtualization
@@ -704,7 +708,7 @@ VPN software.
 - [ocserv](http://www.infradead.org/ocserv/) - Cisco AnyConnect-compatible VPN server. ([Source Code](https://gitlab.com/ocserv/ocserv)) `GPL-2.0` `C`
 - [OpenVPN](https://community.openvpn.net) - Uses a custom security protocol that utilizes SSL/TLS for key exchange. ([Source Code](https://github.com/OpenVPN/openvpn)) `GPL-2.0` `C`
 - [PiVPN](https://www.pivpn.io/) - The simplest way to setup and manage a VPN, designed for Raspberry Pi. ([Source Code](https://github.com/pivpn/pivpn)) `MIT` `Shell`
-- [SoftEther](https://www.softether.org/) - Multi-protocol software VPN with advanced features ([Source Code](https://github.com/SoftEtherVPN/SoftEtherVPN/)) `Apache-2.0` `C`
+- [SoftEther](https://www.softether.org/) - Multi-protocol software VPN with advanced features. ([Source Code](https://github.com/SoftEtherVPN/SoftEtherVPN/)) `Apache-2.0` `C`
 - [sshuttle](https://github.com/sshuttle/sshuttle) - Poor man's VPN. `LGPL-2.1` `Python`
 - [strongSwan](https://www.strongswan.org/) - Complete IPsec implementation for Linux. ([Source Code](https://github.com/strongswan/strongswan)) `GPL-2.0` `C`
 - [tinc](http://www.tinc-vpn.org/) - Distributed p2p VPN. ([Source Code](https://www.tinc-vpn.org/git/tinc)) `GPL-2.0` `C`

From 349d6d5689c78914852df89a0131104a2d2ddf9c Mon Sep 17 00:00:00 2001
From: nodiscc <nodiscc@gmail.com>
Date: Mon, 4 Sep 2023 14:21:20 +0200
Subject: [PATCH 10/12] add missing descriptions for identity management
 sections

---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.md b/README.md
index 9da0aac..1d36273 100644
--- a/README.md
+++ b/README.md
@@ -390,6 +390,8 @@ Open-source code editors.
 
 **[`^        back to top        ^`](#awesome-sysadmin)**
 
+[Lightweight Directory Access Protocol (LDAP)](https://en.wikipedia.org/wiki/Lightweight_Directory_Access_Protocol) is an open, vendor-neutral, industry standard application protocol for accessing and maintaining distributed directory information services over an Internet Protocol (IP) network.
+
 - [389 Directory Server](https://www.port389.org/) - Enterprise-class Open Source LDAP server for Linux. ([Source Code](https://github.com/389ds/389-ds-base)) `GPL-3.0` `C`
 - [Apache Directory Server](https://directory.apache.org/apacheds/) - Extensible and embeddable directory server, certified LDAPv3 compatible, with Kerberos 5 and Change Password Protocol support, triggers, stored procedures, queues and views. ([Source Code](https://github.com/apache/directory-server)) `Apache-2.0` `Java`
 - [FreeIPA](https://www.freeipa.org/) - Integrated security information management solution combining Linux (Fedora), 389 Directory Server, Kerberos, NTP, DNS, and Dogtag Certificate System (web interface and command-line administration tools). ([Source Code](https://pagure.io/freeipa)) `GPL-3.0` `Python/C/JavaScript`
@@ -402,6 +404,8 @@ Open-source code editors.
 
 **[`^        back to top        ^`](#awesome-sysadmin)**
 
+Miscellaneous utilities and web interfaces for identity management systems.
+
 - [BounCA](https://bounca.org/) - A personal SSL Key / Certificate Authority web-based tool for creating self-signed certificates. ([Source Code](https://gitlab.com/bounca/bounca/)) `Apache-2.0` `Python`
 - [easy-rsa](https://github.com/OpenVPN/easy-rsa) - bash script to build and manage a PKI CA. `GPL-2.0` `Shell`
 - [Fusion Directory](https://www.fusiondirectory.org) - Improve the Management of the services and the company directory based on OpenLDAP. ([Source Code](https://github.com/fusiondirectory/fusiondirectory)) `GPL-2.0` `PHP`
@@ -418,6 +422,8 @@ Open-source code editors.
 
 **[`^        back to top        ^`](#awesome-sysadmin)**
 
+[Single sign-on (SSO)](https://en.wikipedia.org/wiki/Single_sign-on) is an authentication scheme that allows a user to log in with a single ID to any of several related, yet independent, software systems. 
+
 - [Authelia](https://www.authelia.com/) - The Single Sign-On Multi-Factor portal for web apps. ([Source Code](https://github.com/authelia/authelia)) `Apache-2.0` `Go`
 - [Authentik](https://goauthentik.io/) - Flexible identity provider with support for different protocols. (OAuth 2.0, SAML, LDAP and Radius). ([Source Code](https://github.com/goauthentik/authentik)) `MIT` `Python`
 - [KeyCloak](https://www.keycloak.org) - Open Source Identity and Access Management. ([Source Code](https://github.com/keycloak/keycloak)) `Apache-2.0` `Java`

From e077639e826e187174b82932af4995860ba7a329 Mon Sep 17 00:00:00 2001
From: nodiscc <nodiscc@gmail.com>
Date: Mon, 4 Sep 2023 14:22:43 +0200
Subject: [PATCH 11/12] tools/hecat: only load licenses from licenses.yml -
 licenses-nonfree.yml is not a file or directory

---
 .hecat/awesome-lint.yml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.hecat/awesome-lint.yml b/.hecat/awesome-lint.yml
index bc2adf5..d56bf82 100644
--- a/.hecat/awesome-lint.yml
+++ b/.hecat/awesome-lint.yml
@@ -5,4 +5,3 @@ steps:
       source_directory: ./
       licenses_files:
         - licenses.yml
-        - licenses-nonfree.yml

From 806d039b7f255bacd4e78c5a8c4d4e3faa50e53b Mon Sep 17 00:00:00 2001
From: nodiscc <nodiscc@gmail.com>
Date: Mon, 4 Sep 2023 14:38:44 +0200
Subject: [PATCH 12/12] tools/makefile: add clean target (clean files generated
 by automated tasks)

---
 Makefile | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Makefile b/Makefile
index b87fa49..e4a08f1 100644
--- a/Makefile
+++ b/Makefile
@@ -24,6 +24,10 @@ url_check: install
 	source .venv/bin/activate && \
 	hecat --config .hecat/url-check.yml
 
+.PHONY: clean # clean files generated by automated tasks
+clean:
+	rm -rf .venv/ licenses.yml platforms/ software/ tags/
+
 .PHONY: help # generate list of targets with descriptions
 help:
 	@grep '^.PHONY: .* #' Makefile | sed 's/\.PHONY: \(.*\) # \(.*\)/\1	\2/' | expand -t20