feat: Add comprehensive documentation translations

This commit introduces a significant internationalization update by translating the project's README and the entire contents of the /documentation directory into seven additional languages:
- German (de)
- Spanish (es)
- French (fr)
- Hindi (hi)
- Portuguese (pt)
- Russian (ru)
- Simplified Chinese (zh-CN)

To better support this multilingual structure, the original English documentation has been moved from the root of the /documentation directory into a new `en/` subdirectory.

All internal markdown links have been carefully updated across all files to ensure they point to the correct relative paths for the new localized directory structure. This includes updating the main README to link to the translated READMEs and ensuring all cross-references within the documentation files work correctly for each language.

Author: google-labs-jules[bot]

README.md

@@ -40,9 +40,9 @@ Read this in other languages: [Simplified Chinese](documentation/README.zh-CN.md
 
 ## Getting Started
 
-To integrate **AppState** into your Swift project, you’ll need to use the Swift Package Manager. Follow the [Installation Guide](documentation/installation.md) for detailed instructions on setting up **AppState**.
+To integrate **AppState** into your Swift project, you’ll need to use the Swift Package Manager. Follow the [Installation Guide](documentation/en/installation.md) for detailed instructions on setting up **AppState**.
 
-After installation, refer to the [Usage Overview](documentation/usage-overview.md) for a quick introduction on how to manage state and inject dependencies into your project.
+After installation, refer to the [Usage Overview](documentation/en/usage-overview.md) for a quick introduction on how to manage state and inject dependencies into your project.
 
 ## Quick Example
 
@@ -76,28 +76,28 @@ This snippet demonstrates defining a state value in an `Application` extension a
 
 Here’s a detailed breakdown of **AppState**'s documentation:
 
-- [Installation Guide](documentation/installation.md): How to add **AppState** to your project using Swift Package Manager.
-- [Usage Overview](documentation/usage-overview.md): An overview of key features with example implementations.
+- [Installation Guide](documentation/en/installation.md): How to add **AppState** to your project using Swift Package Manager.
+- [Usage Overview](documentation/en/usage-overview.md): An overview of key features with example implementations.
 
 ### Detailed Usage Guides:
 
-- [State and Dependency Management](documentation/usage-state-dependency.md): Centralize state and inject dependencies throughout your app.
-- [Slicing State](documentation/usage-slice.md): Access and modify specific parts of the state.
-- [StoredState Usage Guide](documentation/usage-storedstate.md): How to persist lightweight data using `StoredState`.
-- [FileState Usage Guide](documentation/usage-filestate.md): Learn how to persist larger amounts of data securely on disk.
-- [Keychain SecureState Usage](documentation/usage-securestate.md): Store sensitive data securely using the Keychain.
-- [iCloud Syncing with SyncState](documentation/usage-syncstate.md): Keep state synchronized across devices using iCloud.
-- [FAQ](documentation/faq.md): Answers to common questions when using **AppState**.
-- [Constant Usage Guide](documentation/usage-constant.md): Access read-only values from your state.
-- [ObservedDependency Usage Guide](documentation/usage-observeddependency.md): Work with `ObservableObject` dependencies in your views.
-- [Advanced Usage](documentation/advanced-usage.md): Techniques like just‑in‑time creation and preloading dependencies.
-- [Best Practices](documentation/best-practices.md): Tips for structuring your app’s state effectively.
-- [Migration Considerations](documentation/migration-considerations.md): Guidance when updating persisted models.
+- [State and Dependency Management](documentation/en/usage-state-dependency.md): Centralize state and inject dependencies throughout your app.
+- [Slicing State](documentation/en/usage-slice.md): Access and modify specific parts of the state.
+- [StoredState Usage Guide](documentation/en/usage-storedstate.md): How to persist lightweight data using `StoredState`.
+- [FileState Usage Guide](documentation/en/usage-filestate.md): Learn how to persist larger amounts of data securely on disk.
+- [Keychain SecureState Usage](documentation/en/usage-securestate.md): Store sensitive data securely using the Keychain.
+- [iCloud Syncing with SyncState](documentation/en/usage-syncstate.md): Keep state synchronized across devices using iCloud.
+- [FAQ](documentation/en/faq.md): Answers to common questions when using **AppState**.
+- [Constant Usage Guide](documentation/en/usage-constant.md): Access read-only values from your state.
+- [ObservedDependency Usage Guide](documentation/en/usage-observeddependency.md): Work with `ObservableObject` dependencies in your views.
+- [Advanced Usage](documentation/en/advanced-usage.md): Techniques like just‑in‑time creation and preloading dependencies.
+- [Best Practices](documentation/en/best-practices.md): Tips for structuring your app’s state effectively.
+- [Migration Considerations](documentation/en/migration-considerations.md): Guidance when updating persisted models.
 
 ## Contributing
 
-We welcome contributions! Please check out our [Contributing Guide](documentation/contributing.md) for how to get involved.
+We welcome contributions! Please check out our [Contributing Guide](documentation/en/contributing.md) for how to get involved.
 
 ## Next Steps
 
-With **AppState** installed, you can start exploring its key features by checking out the [Usage Overview](documentation/usage-overview.md) and more detailed guides. Get started with managing state and dependencies effectively in your Swift projects! For more advanced usage techniques, like Just-In-Time creation and preloading dependencies, see the [Advanced Usage Guide](documentation/advanced-usage.md). You can also review the [Constant](documentation/usage-constant.md) and [ObservedDependency](documentation/usage-observeddependency.md) guides for additional features.
+With **AppState** installed, you can start exploring its key features by checking out the [Usage Overview](documentation/en/usage-overview.md) and more detailed guides. Get started with managing state and dependencies effectively in your Swift projects! For more advanced usage techniques, like Just-In-Time creation and preloading dependencies, see the [Advanced Usage Guide](documentation/en/advanced-usage.md). You can also review the [Constant](documentation/en/usage-constant.md) and [ObservedDependency](documentation/en/usage-observeddependency.md) guides for additional features.

documentation/README.de.md

@@ -38,9 +38,9 @@
 
 ## Erste Schritte
 
-Um **AppState** in Ihr Swift-Projekt zu integrieren, müssen Sie den Swift Package Manager verwenden. Befolgen Sie die [Installationsanleitung](documentation/de/installation.md) für detaillierte Anweisungen zur Einrichtung von **AppState**.
+Um **AppState** in Ihr Swift-Projekt zu integrieren, müssen Sie den Swift Package Manager verwenden. Befolgen Sie die [Installationsanleitung](de/installation.md) für detaillierte Anweisungen zur Einrichtung von **AppState**.
 
-Nach der Installation finden Sie in der [Verwendungsübersicht](documentation/de/usage-overview.md) eine kurze Einführung in die Verwaltung des Zustands und die Injektion von Abhängigkeiten in Ihr Projekt.
+Nach der Installation finden Sie in der [Verwendungsübersicht](de/usage-overview.md) eine kurze Einführung in die Verwaltung des Zustands und die Injektion von Abhängigkeiten in Ihr Projekt.
 
 ## Schnelles Beispiel
 
@@ -74,28 +74,28 @@ Dieser Ausschnitt zeigt, wie man einen Zustandswert in einer `Application`-Erwei
 
 Hier ist eine detaillierte Aufschlüsselung der Dokumentation von **AppState**:
 
-- [Installationsanleitung](documentation/de/installation.md): So fügen Sie **AppState** mit dem Swift Package Manager zu Ihrem Projekt hinzu.
-- [Verwendungsübersicht](documentation/de/usage-overview.md): Eine Übersicht über die wichtigsten Funktionen mit Beispielimplementierungen.
+- [Installationsanleitung](de/installation.md): So fügen Sie **AppState** mit dem Swift Package Manager zu Ihrem Projekt hinzu.
+- [Verwendungsübersicht](de/usage-overview.md): Eine Übersicht über die wichtigsten Funktionen mit Beispielimplementierungen.
 
 ### Detaillierte Verwendungsanleitungen:
 
-- [Zustands- und Abhängigkeitsmanagement](documentation/de/usage-state-dependency.md): Zentralisieren Sie den Zustand und injizieren Sie Abhängigkeiten in Ihrer gesamten App.
-- [Zustand slicen](documentation/de/usage-slice.md): Greifen Sie auf bestimmte Teile des Zustands zu und ändern Sie sie.
-- [StoredState-Verwendungsanleitung](documentation/de/usage-storedstate.md): So persistieren Sie leichtgewichtige Daten mit `StoredState`.
-- [FileState-Verwendungsanleitung](documentation/de/usage-filestate.md): Erfahren Sie, wie Sie größere Datenmengen sicher auf der Festplatte persistieren.
-- [SecureState mit Schlüsselbund verwenden](documentation/de/usage-securestate.md): Speichern Sie sensible Daten sicher mit dem Schlüsselbund.
-- [iCloud-Synchronisierung mit SyncState](documentation/de/usage-syncstate.md): Halten Sie den Zustand über Geräte hinweg mit iCloud synchron.
-- [FAQ](documentation/de/faq.md): Antworten auf häufig gestellte Fragen zur Verwendung von **AppState**.
-- [Konstanten-Verwendungsanleitung](documentation/de/usage-constant.md): Greifen Sie auf schreibgeschützte Werte aus Ihrem Zustand zu.
-- [ObservedDependency-Verwendungsanleitung](documentation/de/usage-observeddependency.md): Arbeiten Sie mit `ObservableObject`-Abhängigkeiten in Ihren Ansichten.
-- [Erweiterte Verwendung](documentation/de/advanced-usage.md): Techniken wie Just-in-Time-Erstellung und Vorabladen von Abhängigkeiten.
-- [Beste Praktiken](documentation/de/best-practices.md): Tipps zur effektiven Strukturierung des Zustands Ihrer App.
-- [Überlegungen zur Migration](documentation/de/migration-considerations.md): Anleitung zur Aktualisierung persistierter Modelle.
+- [Zustands- und Abhängigkeitsmanagement](de/usage-state-dependency.md): Zentralisieren Sie den Zustand und injizieren Sie Abhängigkeiten in Ihrer gesamten App.
+- [Zustand slicen](de/usage-slice.md): Greifen Sie auf bestimmte Teile des Zustands zu und ändern Sie sie.
+- [StoredState-Verwendungsanleitung](de/usage-storedstate.md): So persistieren Sie leichtgewichtige Daten mit `StoredState`.
+- [FileState-Verwendungsanleitung](de/usage-filestate.md): Erfahren Sie, wie Sie größere Datenmengen sicher auf der Festplatte persistieren.
+- [SecureState mit Schlüsselbund verwenden](de/usage-securestate.md): Speichern Sie sensible Daten sicher mit dem Schlüsselbund.
+- [iCloud-Synchronisierung mit SyncState](de/usage-syncstate.md): Halten Sie den Zustand über Geräte hinweg mit iCloud synchron.
+- [FAQ](de/faq.md): Antworten auf häufig gestellte Fragen zur Verwendung von **AppState**.
+- [Konstanten-Verwendungsanleitung](de/usage-constant.md): Greifen Sie auf schreibgeschützte Werte aus Ihrem Zustand zu.
+- [ObservedDependency-Verwendungsanleitung](de/usage-observeddependency.md): Arbeiten Sie mit `ObservableObject`-Abhängigkeiten in Ihren Ansichten.
+- [Erweiterte Verwendung](de/advanced-usage.md): Techniken wie Just-in-Time-Erstellung und Vorabladen von Abhängigkeiten.
+- [Beste Praktiken](de/best-practices.md): Tipps zur effektiven Strukturierung des Zustands Ihrer App.
+- [Überlegungen zur Migration](de/migration-considerations.md): Anleitung zur Aktualisierung persistierter Modelle.
 
 ## Mitwirken
 
-Wir freuen uns über Beiträge! Bitte lesen Sie unsere [Anleitung für Mitwirkende](documentation/de/contributing.md), um zu erfahren, wie Sie sich beteiligen können.
+Wir freuen uns über Beiträge! Bitte lesen Sie unsere [Anleitung für Mitwirkende](de/contributing.md), um zu erfahren, wie Sie sich beteiligen können.
 
 ## Nächste Schritte
 
-Nach der Installation von **AppState** können Sie die wichtigsten Funktionen erkunden, indem Sie sich die [Verwendungsübersicht](documentation/de/usage-overview.md) und detailliertere Anleitungen ansehen. Beginnen Sie mit der effektiven Verwaltung von Zustand und Abhängigkeiten in Ihren Swift-Projekten! Für fortgeschrittenere Verwendungstechniken wie die Just-In-Time-Erstellung und das Vorabladen von Abhängigkeiten siehe die [Anleitung zur erweiterten Verwendung](documentation/de/advanced-usage.md). Sie können auch die Anleitungen zu [Konstanten](documentation/de/usage-constant.md) und [ObservedDependency](documentation/de/usage-observeddependency.md) für zusätzliche Funktionen einsehen.
+Nach der Installation von **AppState** können Sie die wichtigsten Funktionen erkunden, indem Sie sich die [Verwendungsübersicht](de/usage-overview.md) und detailliertere Anleitungen ansehen. Beginnen Sie mit der effektiven Verwaltung von Zustand und Abhängigkeiten in Ihren Swift-Projekten! Für fortgeschrittenere Verwendungstechniken wie die Just-In-Time-Erstellung und das Vorabladen von Abhängigkeiten siehe die [Anleitung zur erweiterten Verwendung](de/advanced-usage.md). Sie können auch die Anleitungen zu [Konstanten](de/usage-constant.md) und [ObservedDependency](de/usage-observeddependency.md) für zusätzliche Funktionen einsehen.

documentation/README.es.md

@@ -38,9 +38,9 @@
 
 ## Empezando
 
-Para integrar **AppState** en su proyecto de Swift, necesitará usar el Swift Package Manager. Siga la [Guía de Instalación](documentation/es/installation.md) para obtener instrucciones detalladas sobre cómo configurar **AppState**.
+Para integrar **AppState** en su proyecto de Swift, necesitará usar el Swift Package Manager. Siga la [Guía de Instalación](es/installation.md) para obtener instrucciones detalladas sobre cómo configurar **AppState**.
 
-Después de la instalación, consulte la [Descripción General del Uso](documentation/es/usage-overview.md) para una introducción rápida sobre cómo gestionar el estado e inyectar dependencias en su proyecto.
+Después de la instalación, consulte la [Descripción General del Uso](es/usage-overview.md) para una introducción rápida sobre cómo gestionar el estado e inyectar dependencias en su proyecto.
 
 ## Ejemplo Rápido
 
@@ -74,28 +74,28 @@ Este fragmento demuestra cómo definir un valor de estado в una extensión de `
 
 Aquí hay un desglose detallado de la documentación de **AppState**:
 
-- [Guía de Instalación](documentation/es/installation.md): Cómo agregar **AppState** a su proyecto usando Swift Package Manager.
-- [Descripción General del Uso](documentation/es/usage-overview.md): Una descripción general de las características clave con implementaciones de ejemplo.
+- [Guía de Instalación](es/installation.md): Cómo agregar **AppState** a su proyecto usando Swift Package Manager.
+- [Descripción General del Uso](es/usage-overview.md): Una descripción general de las características clave con implementaciones de ejemplo.
 
 ### Guías de Uso Detalladas:
 
-- [Gestión de Estado y Dependencias](documentation/es/usage-state-dependency.md): Centralice el estado e inyecte dependencias en toda su aplicación.
-- [Slicing de Estado](documentation/es/usage-slice.md): Acceda y modifique partes específicas del estado.
-- [Guía de Uso de StoredState](documentation/es/usage-storedstate.md): Cómo persistir datos ligeros usando `StoredState`.
-- [Guía de Uso de FileState](documentation/es/usage-filestate.md): Aprenda a persistir grandes cantidades de datos de forma segura en el disco.
-- [Uso de SecureState con Llavero](documentation/es/usage-securestate.md): Almacene datos sensibles de forma segura usando el Llavero.
-- [Sincronización con iCloud usando SyncState](documentation/es/usage-syncstate.md): Mantenga el estado sincronizado en todos los dispositivos usando iCloud.
-- [Preguntas Frecuentes](documentation/es/faq.md): Respuestas a preguntas comunes al usar **AppState**.
-- [Guía de Uso de Constantes](documentation/es/usage-constant.md): Acceda a valores de solo lectura de su estado.
-- [Guía de Uso de ObservedDependency](documentation/es/usage-observeddependency.md): Trabaje con dependencias de `ObservableObject` en sus vistas.
-- [Uso Avanzado](documentation/es/advanced-usage.md): Técnicas como la creación justo a tiempo y la precarga de dependencias.
-- [Mejores Prácticas](documentation/es/best-practices.md): Consejos para estructurar el estado de su aplicación de manera efectiva.
-- [Consideraciones sobre la Migración](documentation/es/migration-considerations.md): Orientación al actualizar modelos persistentes.
+- [Gestión de Estado y Dependencias](es/usage-state-dependency.md): Centralice el estado e inyecte dependencias en toda su aplicación.
+- [Slicing de Estado](es/usage-slice.md): Acceda y modifique partes específicas del estado.
+- [Guía de Uso de StoredState](es/usage-storedstate.md): Cómo persistir datos ligeros usando `StoredState`.
+- [Guía de Uso de FileState](es/usage-filestate.md): Aprenda a persistir grandes cantidades de datos de forma segura en el disco.
+- [Uso de SecureState con Llavero](es/usage-securestate.md): Almacene datos sensibles de forma segura usando el Llavero.
+- [Sincronización con iCloud usando SyncState](es/usage-syncstate.md): Mantenga el estado sincronizado en todos los dispositivos usando iCloud.
+- [Preguntas Frecuentes](es/faq.md): Respuestas a preguntas comunes al usar **AppState**.
+- [Guía de Uso de Constantes](es/usage-constant.md): Acceda a valores de solo lectura de su estado.
+- [Guía de Uso de ObservedDependency](es/usage-observeddependency.md): Trabaje con dependencias de `ObservableObject` en sus vistas.
+- [Uso Avanzado](es/advanced-usage.md): Técnicas como la creación justo a tiempo y la precarga de dependencias.
+- [Mejores Prácticas](es/best-practices.md): Consejos para estructurar el estado de su aplicación de manera efectiva.
+- [Consideraciones sobre la Migración](es/migration-considerations.md): Orientación al actualizar modelos persistentes.
 
 ## Contribuciones
 
-¡Aceptamos contribuciones! Consulte nuestra [Guía de Contribuciones](documentation/es/contributing.md) para saber cómo participar.
+¡Aceptamos contribuciones! Consulte nuestra [Guía de Contribuciones](es/contributing.md) para saber cómo participar.
 
 ## Próximos Pasos
 
-Con **AppState** instalado, puede comenzar a explorar sus características clave consultando la [Descripción General del Uso](documentation/es/usage-overview.md) y guías más detalladas. ¡Comience a gestionar el estado y las dependencias de manera efectiva en sus proyectos de Swift! Para técnicas de uso más avanzadas, como la creación Justo a Tiempo y la precarga de dependencias, consulte la [Guía de Uso Avanzado](documentation/es/advanced-usage.md). También puede revisar las guías de [Constantes](documentation/es/usage-constant.md) y [ObservedDependency](documentation/es/usage-observeddependency.md) para características adicionales.
+Con **AppState** instalado, puede comenzar a explorar sus características clave consultando la [Descripción General del Uso](es/usage-overview.md) y guías más detalladas. ¡Comience a gestionar el estado y las dependencias de manera efectiva en sus proyectos de Swift! Para técnicas de uso más avanzadas, como la creación Justo a Tiempo y la precarga de dependencias, consulte la [Guía de Uso Avanzado](es/advanced-usage.md). También puede revisar las guías de [Constantes](es/usage-constant.md) y [ObservedDependency](es/usage-observeddependency.md) para características adicionales.