# [2025] Update OWASP Top 10 for 2025 Release - Documentation and Structure

2025/Presentations/README.md

@@ -1 +1,49 @@
-Folder for presentations on Top 10 2024
+# OWASP Top 10 2025 Presentations
+
+This directory contains official presentation materials for the OWASP Top 10 2025 release.
+
+## Directory Contents
+
+- PowerPoint presentations in multiple languages
+- Supporting materials and speaker notes
+- Graphics and visual assets
+
+## Versioning
+
+All presentations will be versioned according to the following scheme:
+- Draft versions: OWASP-Top-10-2025-Draft-YYYY-MM-DD
+- Release versions: OWASP-Top-10-2025-Release-[Language]
+
+## Languages
+
+Presentations are planned to be available in:
+- English (en)
+- Spanish (es)
+- French (fr)
+- German (de)
+- Japanese (ja)
+- Chinese (zh)
+- Portuguese (pt)
+- And more through community contributions
+
+## Contributing
+
+To contribute translations or improvements:
+1. Fork the repository
+2. Create your feature branch
+3. Submit a pull request with your changes
+
+## Quality Guidelines
+
+- All presentations must follow the official OWASP branding guidelines
+- Content must be technically accurate and peer-reviewed
+- Translations must be verified by native speakers
+- All graphics must be high resolution and properly licensed
+
+## Release Schedule
+
+- Initial Draft: Q1 2025
+- Community Review: Q2-Q3 2025
+- Final Release: Q4 2025
+
+For questions or contributions, please open an issue in the main repository or contact the OWASP Top 10 project leaders.

2025/docs/README.md

@@ -1 +1,41 @@
-Folder for site documents
+# OWASP Top 10 2025 Documentation
+
+## Status: IN DEVELOPMENT
+
+This directory contains the official documentation for the OWASP Top 10 2025 release.
+
+## Document Structure
+
+The documentation follows the standard OWASP Top 10 format with sections for:
+
+1. About OWASP
+2. Table of Contents
+3. Introduction
+4. Risk Factors
+5. Top 10 Categories
+6. Data Methodology
+7. Additional Information for Stakeholders
+8. How to Use the OWASP Top 10
+9. References and Further Reading
+
+## Current Development Status
+
+This version is incorporating:
+- Latest threat intelligence data
+- Emerging technology risks
+- Cloud-native security concerns
+- API security threats
+- Machine Learning/AI-related vulnerabilities
+- Supply chain security risks
+
+## Contributing
+
+We welcome community contributions. Please see CONTRIBUTING.md in the root directory for guidelines.
+
+## Translation Status
+
+Translations will begin once the English version reaches RC (Release Candidate) status.
+
+## Build Instructions
+
+See the README.md in the root directory for instructions on building the documentation.

2025/mkdocs.yml

@@ -1,3 +1,137 @@
+site_name: OWASP Top 10 - 2025
+site_description: OWASP Top 10 2025 Release
+site_author: OWASP Foundation
+repo_url: https://github.com/OWASP/Top10
+repo_name: OWASP/Top10
+edit_uri: edit/master/2025/docs/
+site_url: https://owasp.org/Top10
+docs_dir: docs
+site_dir: site
+strict: true
+
+# Version info
+extra:
+  version:
+    provider: mike
+    default: latest
+
+nav:
+  - Home: index.md
+  - About OWASP: about-owasp.md
+  - Methodology: methodology.md
+  - Risk Factors: risk-factors.md
+  - Top 10 Categories:
+    - A01 - AI and ML Vulnerabilities: A01-ai-ml-vulnerabilities.md
+    - A02 - Supply Chain Compromises: A02-supply-chain-compromises.md
+    - A03 - API Security Failures: A03-api-security-failures.md
+    - A04 - Cloud Misconfigurations: A04-cloud-misconfigurations.md
+    - A05 - Authentication Failures: A05-authentication-failures.md
+    - A06 - Insecure Design: A06-insecure-design.md
+    - A07 - Data Protection Failures: A07-data-protection-failures.md
+    - A08 - Software Component Vulnerabilities: A08-software-component-vulnerabilities.md
+    - A09 - Security Observability Failures: A09-security-observability-failures.md
+    - A10 - Zero Trust Violations: A10-zero-trust-violations.md
+  - For Developers: for-developers.md
+  - For Testers: for-testers.md
+  - For Organizations: for-organizations.md
+  - Data Analysis: data-analysis.md
+  - Contributing: contributing.md
+
+theme:
+  name: material
+  custom_dir: overrides
+  font:
+    text: Roboto
+    code: Roboto Mono
+  palette:
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      primary: red
+      accent: red
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      primary: red
+      accent: red
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+  features:
+    - navigation.tabs
+    - navigation.sections
+    - navigation.expand
+    - navigation.top
+    - navigation.tracking
+    - navigation.indexes
+    - search.highlight
+    - search.share
+    - search.suggest
+    - content.code.copy
+    - content.action.edit
+    - content.action.view
+    - toc.follow
+    - announce.dismiss
+
+markdown_extensions:
+  - admonition
+  - pymdownx.details
+  - pymdownx.superfences
+  - pymdownx.highlight
+  - footnotes
+  - attr_list
+  - def_list
+  - tables
+  - meta
+  - md_in_html
+
+plugins:
+  - search
+  - git-revision-date-localized
+  - minify:
+      minify_html: true
+      minify_js: true
+      minify_css: true
+  - i18n:
+      default_language: en
+      languages:
+        en: English
+        es: Español
+        fr: Français
+        de: Deutsch
+        ja: 日本語
+        zh: 中文
+        pt: Português
+  - social:
+      cards_color:
+        fill: "#e8413e"
+        text: "#ffffff"
+  - analytics:
+      provider: google
+      property: !ENV GOOGLE_ANALYTICS_KEY
+  - feedback:
+      title: Was this page helpful?
+      ratings:
+        - icon: material/emoticon-happy-outline
+          name: This page was helpful
+          data: 1
+          note: Thanks for your feedback!
+        - icon: material/emoticon-sad-outline
+          name: This page could be improved
+          data: 0
+          note: Thanks for your feedback! Help us improve this page by using our feedback form.
+
+extra:
+  social:
+    - icon: fontawesome/brands/github
+      link: https://github.com/OWASP/Top10
+    - icon: fontawesome/brands/twitter
+      link: https://twitter.com/owasp
+    - icon: fontawesome/solid/globe
+      link: https://owasp.org
+
+copyright: Copyright © 2025 OWASP Foundation
 site_name: OWASP Top 10:2025
 site_description: OWASP Top 10:2025
 repo_name: OWASP/Top10

README.md

@@ -2,10 +2,15 @@
 
 Official OWASP Top 10 Document Repository
 
-## OWASP Top 10 2021 - RELEASED
+## OWASP Top 10 2025 - IN DEVELOPMENT
 
+The OWASP Top 10 2025 is currently under development. We welcome community feedback and contributions.
 Please log any [feedback, comments, or log issues](https://github.com/OWASP/Top10/issues) here.
 
+## OWASP Top 10 2021 - CURRENT
+
+The OWASP Top 10 2021 remains the current stable version until the 2025 release is finalized.
+
 ## OWASP Top 10 2017 - SUPERSEDED
 
 We have released the OWASP Top 10 - 2017 (Final)