Skip to content

Enhance documentation with SEO improvements and new content#1290

Open
MichaelOv wants to merge 44 commits intomainfrom
kb-overhaul-2026-04
Open

Enhance documentation with SEO improvements and new content#1290
MichaelOv wants to merge 44 commits intomainfrom
kb-overhaul-2026-04

Conversation

@MichaelOv
Copy link
Copy Markdown
Member

This update includes extensive SEO optimizations, the addition of new articles, and a complete English translation of existing content. It also addresses various issues such as duplicate descriptions, broken links, and typos, while enhancing navigation and adding new sections for better user experience. The installation documentation has been updated for various distributions, and new installation guides for Docker and IIS have been introduced. Overall, this enhances the knowledge base significantly.

MartinHartkopf and others added 30 commits April 8, 2026 22:04
- 715 articles with frontmatter (title, description, lang)
- Umlaut corrections (ae/oe/ue → ä/ö/ü) across ~150 articles
- 65 duplicate descriptions fixed
- 7 articles completely rewritten (Security, PHP Update, Backup, Cronjobs, Update, What is i-doit, Concepts)
- New FAQ page (~40 questions)
- i-doit Cloud section expanded (Flows Lite, On-Prem vs Cloud comparison)
- Introduction section expanded (2 new articles)
- New use case: Prod-Test Database Synchronization
- 26 new screenshots with border+shadow
- 19 thin content pages expanded
- 25 index stubs enriched with descriptions
- 6 duplicate titles resolved
- 27 "See also" sections added
- 94 broken internal links fixed
- hreflang tags set to absolute URLs
- Full EN translation of all 715 articles
- EN navigation labels translated

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…eenshots

- 122 category reference articles (DE)
- 78 object type reference articles (DE)
- New articles: Was ist i-doit, Konzepte, Prod-Test Sync, Objekttyp-Konfiguration
- Full EN translation in new path structure (docs/en/)
- 26 new screenshots with border+shadow

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The EN docs now use the same directory structure as DE (grundlagen/,
wartung-und-betrieb/, etc.) instead of the old English paths (basics/,
maintenance-and-operation/). Updated nav with English labels.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1. config/en/mkdocs.yml: overrides/ → ../../overrides/ (4 paths)
2. Fix typo "wiederhfirstllen" → "wiederherstellen" in 37 EN files
3. Fix nav reference objekttypen.md → objekttyp-konfiguration.md (DE+EN)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1. Fix "benutzerdefinede" → "benutzerdefinierte" in 34 EN files
2. Fix "firstllen" → "erstellen" in 2 EN files
3. Fix broken category cross-references DE+EN (6 wrong filenames)
4. Copy adapter files to sm-view-connect/ for EN nav compatibility

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1. Remove 7 broken image references (screenshots not yet created)
2. Fix malformed link path in auswertungen/cmdb-explorer/index.md

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Complete translation of ~200 navigation labels including:
- Object types, categories, installation, maintenance
- Authentication (2FA, SSO, LDAP, Google Auth)
- Add-on sections (Checkmk2, VIVA, Forms, Flows, Documents)
- Software development, use cases, upgrades
- Administration subsections

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
fix6.js and fix6b.js were old screenshot helper scripts
accidentally committed to the images directory.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- cronjobs-einrichten.md: #beispiel-fur-den-befehl-* → #example-for-the-*-command
- update-einspielen.md: #aktualisieren-der-reports → #updating-reports-after-an-update
- release-notes-1.19.md: #report-exportierenimportieren → #exportingimporting-reports

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Path was partially translated during EN translation.
All references now point to the correct directory name.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1. vordefinede-inhalte → vordefinierte-inhalte (links + image paths)
2. saved-werden → gespeichert-werden (troubleshooting paths)
3. dokumentfirstllung/dokumentenfirstllung → dokumenterstellung
4. automated-vertragsverlaengerung → automatisierte-vertragsverlaengerung
5. first-schritte → erste-schritte
6. system-administration → administration
7. automatic-installation → automatische-installation
8. imported.md → importiert.md
9. password-und-Login → Passwort-und-Login
10. Hfirstller → Hersteller (DB model tables + API examples)
11. Wiederherstellungszeit fixed in DB model tables

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1. dokumenterstellung → dokumentenerstellung (image path, 10 warnings)
2. add-on-packager.md: old EN paths → correct DE paths (6 warnings)
3. Remove 3 broken image references (images don't exist in repo)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
EN URL Migration:
- 37 directories renamed (grundlagen→basics, wartung-und-betrieb→maintenance-and-operation, etc.)
- 131 filenames translated (suche→search, standorte→locations, etc.)
- All internal links updated across ~530 files
- config/en/mkdocs.yml nav updated with new paths

Google OpenID article (DE+EN):
- Rewritten with current Google Cloud Console workflow
- 4 new screenshots from actual Google Console
- Tokens blurred (Client-ID + Client Secret)
- Border + shadow applied to all new images

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Removed images and references to the Baramundi and Telekom adapters from the SM-View Connect documentation.
- Updated the Flows and ISMS add-on documentation by removing unnecessary images and clarifying instructions.
- Enhanced the add-on development guide with additional XML examples for database updates.
- Deleted obsolete images related to notifications and flows from the assets directory.
- Improved formatting and consistency in tables across various documentation files.
- libapache2-mod-php durch php8.4-fpm ersetzt (VHost nutzt FPM/proxy_fcgi)
- Doppelten DocumentRoot und fehlplatzierten DirectoryIndex entfernt

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Ersetzt das monolithische idoit-install-patched.sh durch vier
schlanke, nicht-interaktive Scripts — eines pro unterstützter Distro:

- idoit-install-debian13.sh   (PHP 8.4-FPM, Apache, MariaDB)
- idoit-install-ubuntu2404.sh (PHP 8.3-FPM, Apache, MariaDB 10.11)
- idoit-install-rocky10.sh    (PHP 8.3, httpd, MariaDB 10.11, SELinux)
- idoit-install-opensuse156.sh (PHP 8.2, Apache2, MariaDB, zypper)

Alle Scripts: Konfiguration per Umgebungsvariablen, optionaler
Lizenz-Token, vollständig getestet auf frischen Template-VMs.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…iert

Ubuntu 24.04:
- Doppelten DocumentRoot/DirectoryIndex entfernt (gleicher Fehler wie Debian)
- a2dismod mpm_prefork + proxy-Modul ergänzt
- Veraltete PHP 8 Settings (magic_quotes_gpc, register_globals) entfernt
- mysqli Socket-Pfad auf /var/run/mysqld/mysqld.sock korrigiert

Red Hat Enterprise Linux / Rocky Linux 10:
- EPEL + CRB Repos und Modul-Aktivierung (php:8.3, mariadb:10.11) ergänzt
- php-fpm und fehlende PHP-Pakete zum dnf-Befehl hinzugefügt
- PHP-FPM SetHandler im VHost ergänzt (war komplett fehlend)
- Veraltete PHP 8 Settings entfernt
- table_open_cache_instances aktiviert (gültiger MariaDB-Parameter)

SUSE / openSUSE Leap 15.6:
- apache2-mod-php8 (mod_php) durch php8-fpm/php8-fpm-apache ersetzt
- Paketliste korrigiert: php8-cli, php8-zlib, dom/xmlreader/xmlwriter/xsl ergänzt
- PHP-FPM Socket-Pfad auf /var/run/php-fpm.sock korrigiert
- DocumentRoot /srv/www/htdocs/i-doit → /srv/www/htdocs korrigiert
- a2enmod bereinigt (php8 entfernt, proxy proxy_fcgi rewrite)
- MariaDB-Passwort: ALTER USER durch SET PASSWORD ersetzt
- AppArmor-Abschnitt entfernt (nicht relevant für openSUSE)
- table_open_cache_instances aktiviert

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Debian 13: Hinweis "Getestet mit i-doit 38" ergänzt
- Ubuntu 24.04: Hinweis "Getestet mit i-doit 38" ergänzt
- RHEL/Rocky 10: i-doit 36 → 38, RHEL → Rocky Linux 10.1

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ergänzt

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…rgänzt

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…korrigiert

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Debian:
- magic_quotes_gpc + register_globals entfernt (PHP 8 deprecated)
- a2dismod mpm_prefork + proxy/mpm_event in a2enmod ergänzt

RHEL:
- "Aktivieren Sie" → "Aktiviere" (du-Konsistenz)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
… persistent

- Ubuntu: libapache2-mod-fcgid aus apt-Befehl entfernt (mod_fcgid wird
  nicht verwendet; i-doit nutzt mod_proxy_fcgi via proxy_fcgi-Modul)
- RHEL: chcon durch semanage fcontext + restorecon ersetzt, damit die
  SELinux-Kontextänderung nach restorecon -R erhalten bleibt

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Variante A: rsync-Schritte ergänzt (fehlten im DE-Script komplett)
- Variante A: Script-Pfad von Webroot nach /usr/local/sbin/ verschoben
- Variante B: Interne Zugangsdaten und Pfade entfernt, Platzhalter gesetzt
- Variante B: Automatisiertes Script lesbar formatiert, PROD_TEMP korrigiert
- Variante B Cron: Wildcard *.zip als --file-Argument entfernt (funktioniert
  in Cron nicht), Cronjob ruft jetzt das Script auf
- EN: Automatisiertes Variante-B-Script ergänzt (war nur in DE vorhanden)
- Checkliste bereinigt, Fehlerbehebung um Export-not-found-Eintrag erweitert

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- --with-system-settings und --with-tenant-settings ergänzt (DE + EN)
- --db-host localhost durch Platzhalter <HOST> ersetzt (DE + EN)
- Prod→Test Artikel in DE-Navigation eingetragen

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
MichaelOv and others added 13 commits April 16, 2026 09:19
Split combined RHEL/Rocky article: index.md now covers Rocky Linux 10,
new rhel10.md covers RHEL 10 with subscription-specific EPEL and CRB steps.
Updated navigation in both DE and EN mkdocs.yml.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Neue Sektion "Docker Installation" mit Übersichtsseite sowie je einer
Anleitung für Debian 13 und Ubuntu 24.04. Getestet mit i-doit 38 auf
frischen VMs (sauber ab Snapshot). Navigation in DE und EN ergänzt.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
../../ war ein Level zu viel, korrekt ist ../ von docker-installation/ aus.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ektion ergänzt

- Memcached-Container (memcached:alpine) in docker-compose.yml aller vier Artikel
- MariaDB mariadb.cnf: innodb_flush_method, innodb_stats_on_metadata, sql-mode ergänzt
- Hinweis zu entferntem Query Cache in MariaDB 10.6
- Backup-Sektion mit mysqldump + tar + 14-Tage-Retention
- KB docker-compose.yml: Port-Binding auf 8001:80 (Netzwerkzugang)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- New articles: DE and EN guide for installing i-doit on IIS (Windows Server 2022)
- Installer package: idoit-iis-installer.zip (install.cmd + install.ps1, 12-step automated setup)
- Added to mkdocs nav in both DE and EN configs
- Covers PHP 8.2 NTS, MariaDB 10.6, IIS URL Rewrite, cacert.pem for SSL

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- idoit-iis-installer.zip von docs/assets/ nach docs/de/assets/ und docs/en/assets/ verschoben
- Download-Links in beiden IIS-Artikeln auf ../../../assets/downloads/ korrigiert
- Dockerfile: COPY requirements.txt + pip install vor COPY . . -> pip-Layer gecacht bei Docs-Änderungen

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ext step

- RHEL 10 (DNF5): dnf module enable php:8.3 mariadb:10.11 entfernt — Modularity ist in RHEL 10 deprecated, PHP 8.3 und MariaDB 10.11 sind direkt in AppStream verfügbar
- MariaDB-Config: query_cache_* Einstellungen entfernt (seit MariaDB 10.6 nicht mehr vorhanden)
- IIS-Artikel: Nächster Schritt von Setup auf Systemeinstellungen geändert (Setup bereits im Artikel abgedeckt)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@MichaelOv MichaelOv requested a review from a team as a code owner April 24, 2026 14:57
@MichaelOv MichaelOv self-assigned this Apr 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants