# Microsoft Fabric Notebook Documentation

> **Note:** This documentation is mandatory for all production notebooks.
> Irrelevant chapters may be left empty but must not be removed.
> Automatically populated fields come from the Microsoft Fabric Service; fields
> marked _"To be completed"_ must be filled in from a business perspective.

---

## 1. Metadata

| Field | Value |
|-----|------|
| Notebook Name | {{NB_Name}} |
| Description | {{NB_Beschreibung}} |
| Notebook ID | {{NB_ID}} |
| Web URL | {{NB_WebUrl}} |
| Default Language | {{NB_DefaultLanguage}} |
| Default Lakehouse | {{NB_DefaultLakehouse}} |
| Created / configured by | {{NB_ConfiguredBy}} |
| Last modified | {{NB_ModifiedTime}} |
| Business Unit | {{NB_Fachbereich}} |
| Domain | {{NB_Konzerndomaene}} |
| Current Version | 1.0 |
| Status | Production |
| Last Updated | {{NB_ExportDatum}} |

---

## 2. Contacts & Responsibilities

| Role | Name / Team | Contact |
|-----|-------------|--------|
| Business Owner | {{KONTAKT_BusinessOwner}} | {{KONTAKT_BusinessOwnerMail}} |
| Technical Owner | {{KONTAKT_TechOwner}} | {{KONTAKT_TechOwnerMail}} |
| Data Steward | {{KONTAKT_DataSteward}} | {{KONTAKT_DataStewardMail}} |
| Operations / Support | {{KONTAKT_Betrieb}} | {{KONTAKT_BetriebMail}} |

---

## 3. Business Objective & Context

### 3.1 Objective
{{NB_Zielsetzung}}

### 3.2 Business Use Case
{{NB_Anwendungsfall}}

### 3.3 Downstream Consumers (Pipelines / Reports / other Notebooks)
{{NB_Konsumenten}}

---

## 4. Structure & Layout

### 4.1 Cell Overview

{{NB_ZellenTabelle}}

### 4.2 Languages Used

{{NB_Sprachen}}

---

## 5. Data Sources & Dependencies

### 5.1 Attached Lakehouses / Data Sources

{{NB_DatenquellenTabelle}}

### 5.2 Detailed Description per Data Source
{{NB_DatenquellenDetail}}

---

## 6. Code & Logic

{{NB_ServiceHinweis}}

### 6.1 Cell Content (Code)

{{NB_CodeZellen}}

### 6.2 In-Notebook Documentation (Markdown Cells)

{{NB_MarkdownDoku}}

### 6.3 Parameters & Configuration
{{NB_ParameterHinweis}}

### 6.4 Error Handling & Data Quality

- NULL / missing value handling: {{NB_NullHandling}}
- Error handling (try/except, retries): {{NB_ErrorHandling}}
- Data validation rules: {{NB_Validierungsregeln}}

### 6.5 Performance Notes

- Spark / resource configuration: {{NB_Ressourcen}}
- Known performance bottlenecks: {{NB_PerformanceHinweise}}
- Optimization measures: {{NB_Optimierungen}}

---

## 7. Operations & Maintenance

### 7.1 Execution & Orchestration

{{NB_Ausfuehrung}}

### 7.2 Monitoring & Error Handling
{{NB_Monitoring}}

### 7.3 Known Issues / Technical Debt
{{NB_BekannteProbleme}}

---

## 8. Security & Permissions

### 8.1 Access & Sharing
{{NB_Zugriffe}}

### 8.2 Sensitivity Labels
{{NB_Labels}}

### 8.3 Risks & Limitations
{{NB_Risiken}}

---

## 9. Versioning & Change History

### 9.1 Repository / Storage
{{NB_Repository}}

### 9.2 Change Log

| Version | Date | Change | Type (business/technical) | Author |
|-------|-------|---------|--------------------------|-------|
| 1.0 | {{NB_ExportDatum}} | Automatic initial documentation | technical | Auto-Documentation |

---

## 10. Approval & Review

| Role | Name | Date | Comment |
|-----|------|-------|----------|
| Business | {{REVIEW_FachName}} | {{REVIEW_FachDatum}} | {{REVIEW_FachKommentar}} |
| Technical | {{REVIEW_TechName}} | {{REVIEW_TechDatum}} | {{REVIEW_TechKommentar}} |

---

## 11. Appendices & References
- Parent workspace documentation
- Architecture diagrams
- Regulatory evidence (separate)
