Update Intro and base structure (#148)

- Adding YAML Source
- Adding menu intro
- Adding menu doku framework
- FAQ no longer exists in the forum
- Base structure implemented

Author: Nirus2000

config/de/mkdocs.yml

@@ -103,7 +103,6 @@ markdown_extensions:
 nav:
   - Intro: 
       - Intro: index.md
-      - Doku Framework: doku-framework.md
   - Erste Schritte:
       - Erste Schritte: erste-schritte/index.md
       - Installation: erste-schritte/installation.md

config/en/mkdocs.yml

@@ -99,6 +99,8 @@ markdown_extensions:
   - tables
 
 nav:
+  - Intro: 
+      - Intro: index.md
   - Getting started:
       - Getting started: getting-started/index.md
       - Installation: getting-started/installation.md

docs/de/doku-framework.md

@@ -1,13 +1,26 @@
 ---
-title: Intro
+title: Einleitung
+template: home.html
+lastUpdate: 2025-05-03
+description: Dieses Handbuch führt in Portfolio Performance ein, erklärt Portfolioverwaltung, Performance-Berechnung (TWRR, interner Zinsfuß) und erste Schritte (Portfolio-Datei, Wertpapiere, Import). Es betont die Vorteile gegenüber Excel und ruft zur Mitarbeit auf. Struktur basiert auf Diataxis (Erste Schritte, Grundlagen, How-to, Referenz).
+authors:
+    - name: Portfolio Performance Team
+    - name: Nirus2000
+version: 1.0
+slug: system-overview
+tags:
+    - Portfolio Management
+    - Investment Analysis
+    - Glossary
+    - Portfolio Performance
+changes:
+    - date: 2025-05-03
+      author: Nirus2000
+      description:
+        - Hinzufügen der YAML-Quelle
+        - Basis Struktur implementiert
 ---
 
-# Über dieses Handbuch
-
-Seit Anfang 2012 gibt es [Portfolio Performance](https://portfolio-performance.info), um die Performance eines Gesamtportfolios zu berechnen - über verschiedene Depots und Konten hinweg - anhand von True-Time Weighted Rate of Return und internem Zinsfuß.
-
-*Portfolio Performance* (PP) selber versucht so einfach und intuitiv zu bleiben wie es nur geht. Aber ohne Erklärungen geht es nicht immer - viele ähnliche Fragen im [Forum](https://forum.portfolio-performance.info) zeigen das. Dieses "Handbuch" soll Euch bei den ersten Schritten mit *Portfolio Performance* begleiten, grundlegende Konzepte erklären und die erklärungsbedürftigen Features dokumentieren.
-
 ## Was ist Portfolio Performance?
 
 *Portfolio Performance* ist ein einfaches und leistungsfähiges Tool für die Pflege Deines Wertpapier-Portfolios. Mit *Portfolio Performance* kannst Du:
@@ -19,59 +32,47 @@ Seit Anfang 2012 gibt es [Portfolio Performance](https://portfolio-performance.i
 - eine übergreifende Sicht über mehrere Depots und Verrechnungskonten herstellen.
 - die Abrechnungen von Online-Banken und -Brokern schnell und bequem zu importieren.
 
-## Warum noch ein Tool, es gibt doch Excel?
-
-Einfache Berechnungen mit Excel oder aus dem Online-Banking liefern falsche Ergebnisse, wenn sie nur auf absoluten Zahlen am Beginn und Ende eines Betrachtungszeitraums beruhen und die Käufe und Verkäufe nicht richtig einrechnen: Ein Kauf erhöht den Wert des Portfolios, ist aber kein Ertrag.
-
-*Portfolio Performance* berechnet die Wertentwicklung finanzmathematisch korrekt anhand von True-Time Weighted Rate of Return und internem Zinsfuß, unter Berücksichtigung der Käufe und Verkäufe zum jeweiligen Ausführungstag.
-
-## Erste Schritte mit Portfolio Performance
-
-Damit du dein Wertpapier-Portfolio mit *Portfolio Performance* verfolgen, bewerten und verwalten kannst, braucht *Portfolio Performance* die grundlegenden Daten zu deinen Depots und den zurückliegenden Transaktionen. Danach kannst du sofort deine ersten Auswertungen machen und dein Portfolio und die Wertentwicklung aus verschiedenen Blickwinkeln analysieren.
-
-### Portfolio-Datei anlegen
-
-Die Portfolio-Datei enthält alle Wertpapiere, Konten, Depots, Buchungen, Klassifizierungen etc..
+# Über dieses Handbuch
 
-- Du erstellst eine neue Portfolio-Datei und legst darin deine Depots und zugehörigen Verrechnungskonten an.
-- [mehr dazu...](erste-schritte/intro-neue-portfoliodatei-anlegen.md)
+Seit Anfang 2012 gibt es [Portfolio Performance](https://portfolio-performance.info), um die Performance eines Gesamtportfolios zu berechnen - über verschiedene Depots und Konten hinweg - anhand von True-Time Weighted Rate of Return und internem Zinsfuß.
 
-### Wertpapiere anlegen
+*Portfolio Performance* (PP) selber versucht so einfach und intuitiv zu bleiben wie es nur geht. Aber ohne Erklärungen geht es nicht immer - viele ähnliche Fragen im [Forum](https://forum.portfolio-performance.info) zeigen das. Dieses "Handbuch" soll Euch bei den ersten Schritten mit *Portfolio Performance* begleiten, grundlegende Konzepte erklären und die erklärungsbedürftigen Features dokumentieren.
 
-- Du legst die für dich interessanten Wertpapiere in der Wertpapierliste an.
-- Stammdaten und historische Kursverläufe werden von *Portfolio Performance* automatisch ergänzt und aktualisiert.
-- [mehr dazu ...](erste-schritte/intro-wertpapiere-anlegen.md)
-### Bestände aufbauen
+![](images/doku_framework.svg)
 
-- Du befüllst Depot und Verrechnungskonto erstmalig mit Beständen und/oder historischen Transaktionen.
-- [mehr dazu ...](erste-schritte/intro-bestaende-erstmalig-aufbauen.md)
+Die **Portfolio Performance** (PP) Anleitung besteht aus vier Kapiteln, die von einem bekannten [Framework zur Erstellung von Dokumentationen](https://fachglossar.platinus.at/docs/Glossar/D-Glossar/Diataxis-Framework/) abgeleitet sind. Die Dokumentation ist entlang zweier Achsen strukturiert: praktisches versus theoretisches Wissen und Lernen versus Anwenden.
 
-### Berichte zur Vermögensaufstellung und Performance abrufen
+- [Erste Schritte](index.md)
+Wenn du neu in Portfolio Performance bist, wird dir dieses Kapitel den Einstieg erleichtern.
+Es behandelt alles von der Installation über die Erstellung eines neuen Portfolios, den Import von Wertpapieren und Transaktionsdaten bis hin zur Auswertung Ihres gesamten Portfolios.
 
-- Wie ist dein Portfolio zusammengesetzt? Die Vermögensaufstellung zeigt die Zusammensetzung des Portfolios als Liste, in der historischen Wertentwicklung und als Kreisdiagramm.
-- Wie ist die aktuelle Performance deines Portfolios? Neben Auswertungen zu Rendite und Volatilität erhältst du einen Überblick der angefallenen Steuern und Kosten.
+- [Grundlagen](grundlagen/index.md)
+Obwohl Portfolio Performance ein äußerst intuitives und benutzerfreundliches Programm ist, können die zugrunde liegenden Finanzkonzepte komplex sein. Dieses Kapitel vermittelt ein kurzes, aber klares Verständnis der wichtigsten Portfolio-Performance-Konzepte, wie Konten, Transaktionen, Berichtszeiträume, interner Zinsfuß und mehr.
 
-### Klassifizierung der Vermögensanteile durchführen
+- [Referenzhandbuch](referenzhandbuch/index.md)
+ist eine detaillierte und technische Beschreibung aller Funktionen und Elemente der Benutzeroberfläche des Programms.
 
-- Mit deiner eigenen, selbst gewählten Struktur stellst du die Gewichtung der Vermögensanteile dar, z. B. nach Regionen und/oder Anlageklassen.
+- [How-to](how-to/index.md)
+In diesem Kapitel findest du Schritt-für-Schritt-Beschreibungen gängiger Verfahren, einschließlich Datenimport, Dividendenbuchung, Suche nach historischen Kursen und mehr. Es werden auch einige Tipps & Tricks sowie Sonderfälle beschrieben.
 
-### Portfolio Strategie definieren und Rebalancing durchführen
+# Über dieses Handbuch
 
-- Du bildest deine eigene Portfoliostrategie mit Soll-Werten für verschiedene Anteilsklassen ab.
-- Du kannst einen Soll-Ist-Vergleich machen und ein Rebalancing durchführen.
+Seit Anfang 2012 gibt es [Portfolio Performance](https://portfolio-performance.info), um die Performance eines Gesamtportfolios zu berechnen - über verschiedene Depots und Konten hinweg - anhand von True-Time Weighted Rate of Return und internem Zinsfuß.
 
-### Das Portfolio auf dem aktuellen Stand halten
+*Portfolio Performance* (PP) selber versucht so einfach und intuitiv zu bleiben wie es nur geht. Aber ohne Erklärungen geht es nicht immer - viele ähnliche Fragen im [Forum](https://forum.portfolio-performance.info) zeigen das. Dieses "Handbuch" soll Euch bei den ersten Schritten mit *Portfolio Performance* begleiten, grundlegende Konzepte erklären und die erklärungsbedürftigen Features dokumentieren.
 
-- Du buchst neue Käufe, Verkäufe und Dividenden sowie anfallende Kosten und Steuern. Das geht einfach und schnell per Import der PDF-Abrechnungen der Bank, oder auch manuell.
+## Was ist Portfolio Performance?
 
-## Weiterführende Themen
+*Portfolio Performance* ist ein einfaches und leistungsfähiges Tool für die Pflege Deines Wertpapier-Portfolios. Mit *Portfolio Performance* kannst Du:
 
-* [Installation](erste-schritte/installation.md)
-* [Währungen](how-to/waehrungen.md)
-* [Konten anlegen](how-to/konten_anlegen.md)
-* [Kursdaten laden](how-to/kursdaten_laden.md)
-* [Buchungen erfassen](how-to/buchungen_erfassen.md)
+- die Zusammensetzung und Entwicklung Deines Wertpapier-Portfolios mit aussagekräftigen Übersichten, Kennzahlen und Diagrammen verfolgen.
+- historische Kursverläufe der Wertpapiere und Deine Käufe und Verkäufe nachverfolgen.
+- die Wertpapiere im Portfolio nach Deinem Bedarf klassifizieren und die Zusammensetzung visualisieren, z. B. nach Anlageklassen und Regionen.
+- die Portfoliostrategie mit Deiner geplanten Asset Allocation definieren, verfolgen und im Rebalancing sicherstellen.
+- eine übergreifende Sicht über mehrere Depots und Verrechnungskonten herstellen.
+- die Abrechnungen von Online-Banken und -Brokern schnell und bequem zu importieren.
 
 ## Mithelfen...
 
-Wie Ihr leicht sehen könnt, gibt es noch viele weiße Seiten in diesem Handbuch. Einige Fragen decken die [Frequently Asked Questions (FAQ)](https://forum.portfolio-performance.info/t/faq-haeufig-gestellte-fragen/1721) im Forum ab. Wer sich berufen fühlt, ist herzlich eingeladen, an diesem Handbuch mitzuschreiben: auf jeder Seite gibt es oben rechts einen kleinen Stift, um die Seite direkt auf [Github](https://github.com/portfolio-performance/portfolio-help) zu bearbeiten. Meldet euch bei Interesse auch im Forum! [Vielen Dank an alle, die bisher schon mitgeholfen haben.](https://github.com/portfolio-performance/portfolio-help/graphs/contributors)
+Wie Ihr leicht sehen könnt, gibt es noch viele weiße Seiten in diesem Handbuch. 
+Meldet euch bei Interesse auch im Forum! [Vielen Dank an alle, die bisher schon mitgeholfen haben.](https://github.com/portfolio-performance/portfolio-help/graphs/contributors)