Feat(documentation): remaining pages and teaser

content/pages/documentation/components/index.mdx

@@ -4,6 +4,7 @@ sectionSpacing: 'small'
 sectionWidth: 'auto'
 title: 'Components'
 headline: 'Components'
+order: 3
 align: start
 toc: true
 description: 'An overview of all available components in the Design System, grouped by maturity: Stable, Beta, and Concept.'

content/pages/documentation/contribution/index.mdx

@@ -0,0 +1,82 @@
+---
+layout: '@template/layouts/documentation'
+sectionSpacing: 'small'
+sectionWidth: 'auto'
+title: 'Contribution'
+headline: 'Contribution'
+description: 'Get involved, share feedback, and help improve the DB UX Design System.'
+align: start
+order: 9
+toc: false
+---
+
+import CardTeaserRow from '@template/components/CardTeaser/CardTeaserRow';
+import { DBSection } from '@db-ux/react-core-components';
+
+<DBSection spacing="small" width="auto">
+
+## Overall & Design
+
+<CardTeaserRow
+	items={[
+		{
+			title: 'GitHub Core',
+			description:
+				'Report design issues, request features, or contribute to the design foundations.',
+			url: 'https://github.com/db-ux-design-system/core',
+			image: '/assets/teasers/github.png',
+			imageAlt: 'GitHub',
+			label: 'View on GitHub',
+			external: true,
+		},
+		{
+			title: 'Feedback via Email',
+			description: 'Reach out to the Design System team directly via email.',
+			url: 'mailto:db-ux-designsystem@deutschebahn.com',
+			image: '/assets/teasers/mail.png',
+			imageAlt: 'Email',
+			label: 'Send Email',
+			external: true,
+		},
+		{
+			title: 'Feedback via DB UX Community (Teams)',
+			description: 'Join the DB UX Design System channel on Microsoft Teams.',
+			url: 'https://teams.microsoft.com/l/channel/19%3A7dd9929be1fe494c823b11e0e2d22341%40thread.skype/DB%20UX%20Design%20System?groupId=72c53609-2941-46dd-8be9-e4d1d2c45c77&tenantId=a1a72d9c-49e6-4f6d-9af6-5aafa1183bfd',
+			image: '/assets/teasers/teams.png',
+			imageAlt: 'Teams',
+			label: 'Open Teams Channel',
+			external: true,
+		},
+	]}
+/>
+
+</DBSection>
+
+<DBSection spacing="small" width="auto">
+
+## Development
+
+<CardTeaserRow
+	items={[
+		{
+			title: 'GitHub Core Web',
+			description: 'Report bugs, request features, or contribute to the component library.',
+			url: 'https://github.com/db-ux-design-system/core-web',
+			image: '/assets/teasers/github.png',
+			imageAlt: 'GitHub',
+			label: 'View on GitHub',
+			external: true,
+		},
+		{
+			title: 'Feedback via Web Community (Teams)',
+			description: 'Join the DB UX Design System channel on Microsoft Teams.',
+			url: 'https://teams.microsoft.com/l/channel/19%3A6c0e92ce4aef409598ff77c4cd06e001%40thread.skype/SIG%20-%20DB%20UX%20Design%20System?groupId=2f363785-c59e-4763-9bc3-8e13998a4588&tenantId=a1a72d9c-49e6-4f6d-9af6-5aafa1183bfd',
+			image: '/assets/teasers/teams.png',
+			imageAlt: 'Teams',
+			label: 'Open Teams Channel',
+			external: true,
+		},
+	]}
+/>
+
+</DBSection>

content/pages/documentation/icons/index.astro

@@ -12,6 +12,7 @@ export const frontmatter: DocumentationFrontMatter = {
 	title: 'Icons',
 	description: 'Browse and copy all available DB UX icon names for use in code.',
 	align: 'start',
+	order: 4,
 };
 
 const iconNames = Object.keys(iconDescriptions);

content/pages/documentation/index.mdx

@@ -1,5 +1,5 @@
 ---
-order: 3
+order: 10
 layout: '@template/layouts/default'
 title: 'Documentation'
 hidePage: true

content/pages/documentation/releases/content-status.mdx

@@ -0,0 +1,147 @@
+---
+layout: '@template/layouts/documentation'
+sectionSpacing: 'small'
+sectionWidth: 'auto'
+title: 'Content Status'
+headline: 'Content Status'
+description: 'What Concept, Beta, Stable, Legacy, and Deprecated mean in the DB UX Design System and what to expect from each status.'
+align: start
+order: 6
+toc: true
+tocMaxDepth: 3
+---
+
+import { DBSection, DBCard, DBBadge, DBStack } from '@db-ux/react-core-components';
+import TeaserCard from '@template/components/TeaserCard/TeaserCard.astro';
+
+<DBSection spacing="small" width="auto">
+
+Every component, pattern, and template in the DB UX Design System has a status that tells you how mature and reliable it is — from early explorations to production-ready standards.
+
+<div style={{ display: 'grid', gridTemplateColumns: 'auto auto', columnGap: 'var(--db-spacing-fixed-lg)', rowGap: 'var(--db-spacing-fixed-xs)', width: 'fit-content' }}>
+
+<DBCard data-density="expressive" style={{ width: 'fit-content' }} spacing="large">
+	<DBStack direction="row" gap="small" alignment="center">
+		<DBBadge semantic="warning">Concept</DBBadge>
+		<span data-icon="arrow_right" />
+		<DBBadge semantic="informational">Beta</DBBadge>
+		<span data-icon="arrow_right" />
+		<DBBadge semantic="successful">Stable</DBBadge>
+	</DBStack>
+</DBCard>
+
+<DBCard data-density="expressive" style={{ width: 'fit-content' }} spacing="large">
+	<DBStack direction="row" gap="small" alignment="center">
+		<DBBadge semantic="critical">Legacy</DBBadge>
+		<DBBadge>Deprecated</DBBadge>
+	</DBStack>
+</DBCard>
+
+<small>Active development lifecycle.</small>
+<small>Superseded or being removed.</small>
+
+</div>
+
+</DBSection>
+<DBSection spacing="small" width="auto">
+
+## Concept
+
+Early visual and functional approaches for new content. At this stage, initial directions are being defined but **nothing is final**. Designs and implementations may **change substantially** as ideas are tested and refined.
+
+You can use concept content as a **design reference** for your own implementation. However, be prepared to **incorporate future changes** once the content matures. Design is always available; a development implementation **may not yet exist** and typically joins in the beta phase.
+
+<DBCard spacing='large' style={{ marginBlockEnd: 'var(--db-spacing-fixed-2xl)' }} data-color="warning">
+### What to expect
+
+- **Design available**, development implementation may follow later
+- **No stability guarantees** — API, design, and accessibility are not yet validated and may change at any time
+- **Limited documentation** and usage guidelines
+- **Plan for rework** as the content matures toward Beta and Stable
+
+</DBCard>
+
+## Beta
+
+Content is **functional and largely stable**, but minor visual or functional changes may still occur. Design and development have been **aligned**, and the content has undergone **initial user testing** — it addresses a **validated user need**.
+
+We recommend **testing Beta content thoroughly** in your projects and sharing feedback to help improve quality and reliability.
+
+<DBCard spacing='large' style={{ marginBlockEnd: 'var(--db-spacing-fixed-2xl)' }} data-color="informational">
+### What to expect
+
+- **Aligned between design and development**
+- Suitable for project use, but **minor breaking changes are still possible**
+- Documentation and usage guidelines are available but may be incomplete
+- Accessibility and cross-browser testing is **underway but not fully validated**
+
+</DBCard>
+
+## Stable
+
+Content is considered **mature and reliable** — accessible, brand-compliant, and Design System conformant. Stable content is **mandatory to use** as the UX standard.
+
+We **continuously update and improve** stable content to ensure it meets user needs and current standards.
+
+<DBCard spacing='large' style={{ marginBlockEnd: 'var(--db-spacing-fixed-2xl)' }} data-color="successful">
+### What to expect
+
+- **Fully validated** for accessibility, cross-browser, and cross-framework compatibility
+- **Complete documentation**, usage guidelines, and design specs
+- **API stability** — breaking changes only happen in Major releases
+- **Ongoing maintenance** and regular improvements
+
+</DBCard>
+
+## Legacy
+
+Content is **outdated and no longer actively developed**. Only limited support in the form of **critical bug fixes** is provided. We recommend **migrating to current Design System content**.
+
+<DBCard spacing='large' style={{ marginBlockEnd: 'var(--db-spacing-fixed-2xl)' }}data-color="critical">
+### What to expect
+
+- **No new features** or improvements
+- Only **critical bug fixes**
+- A **recommended alternative** is available in the Design System
+
+</DBCard>
+
+## Deprecated
+
+Content is **marked for removal** and will be **fully removed in a future Major release**. In design, deprecated content is visually marked first, giving you **time to migrate** before it is removed.
+
+<DBCard spacing='large' style={{ marginBlockEnd: 'var(--db-spacing-fixed-2xl)' }}elevationLevel='2'>
+### What to expect
+
+- **Content will be removed** — plan your migration
+- **No bug fixes** or maintenance
+- A **sufficient transition period** is provided before removal in a major release
+
+</DBCard>
+</DBSection>
+
+<DBSection spacing="small" width="auto">
+
+## Related Content
+
+<TeaserCard
+	teasers={[
+		{
+			title: 'Components',
+			description: 'Browse all components grouped by status: Stable, Beta, and Concept.',
+			url: '/documentation/components',
+		},
+		{
+			title: 'Versioning & Releases',
+			description: 'How we version and release updates across Design and Development.',
+			url: '/documentation/releases/versioning',
+		},
+		{
+			title: 'Contribution',
+			description: 'Share feedback, report issues, or contribute to the Design System.',
+			url: '/documentation/contribution',
+		},
+	]}
+/>
+
+</DBSection>

content/pages/documentation/releases/index.mdx

@@ -0,0 +1,10 @@
+---
+layout: '@template/layouts/documentation'
+sectionSpacing: 'small'
+sectionWidth: 'auto'
+title: 'Releases'
+headline: 'Releases'
+description: 'Everything about releases, versioning, content status, and migration guides for the DB UX Design System.'
+align: start
+order: 6
+---

content/pages/documentation/releases/migration-guides/index.mdx

@@ -0,0 +1,11 @@
+---
+layout: '@template/layouts/documentation'
+sectionSpacing: 'small'
+sectionWidth: 'auto'
+title: 'Migration Guides'
+headline: 'Migration Guides'
+description: 'Step-by-step guides for migrating between major versions of the DB UX Design System.'
+align: start
+order: 1
+sortChildrenDescending: true
+---