Merge pull request #81 from jcdcdev/dev/v12

jcdcdev · web-flow · commit 193f1c002d37 · 2025-06-12T21:35:52.000+01:00
12.0.1
diff --git a/.github/README.md b/.github/README.md
@@ -1,47 +1,48 @@
 # jcdcdev.Umbraco.ExtendedMarkdownEditor
 
-[![Umbraco Marketplace](https://img.shields.io/badge/Umbraco-Marketplace-%233544B1?style=flat&logo=umbraco)](https://marketplace.umbraco.com/package/jcdcdev.umbraco.extendedmarkdowneditor)
-[![GitHub License](https://img.shields.io/github/license/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor?color=8AB803&label=License&logo=github)](https://github.com/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor/blob/main/LICENSE)
-[![NuGet Downloads](https://img.shields.io/nuget/dt/jcdcdev.Umbraco.ExtendedMarkdownEditor?color=cc9900&label=Downloads&logo=nuget)](https://www.nuget.org/packages/jcdcdev.Umbraco.ExtendedMarkdownEditor/)
-
-A lightweight custom property editor for Umbraco that sits on top of the default Umbraco.MarkdownEditor.
-
-## Features
-
-### Property Value Converter
-
-Replaces `IHtmlEncodedString` with `MarkdownValue` which contains the following properties
-
-- **Raw** - The raw markdown as a string
-- **Html** - The transformed HTML value
+[![Umbraco Marketplace](https://img.shields.io/badge/Umbraco-Marketplace-%233544B1?style=flat&logo=umbraco)](https://marketplace.umbraco.com/package/jcdcdev.Umbraco.ExtendedMarkdownEditor)
+[![License](https://img.shields.io/github/license/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor?color=8AB803&label=License&logo=github)](https://github.com/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor?tab=MIT-1-ov-file)
+[![NuGet Downloads](https://img.shields.io/nuget/dt/jcdcdev.Umbraco.ExtendedMarkdownEditor?color=cc9900&label=Downloads&logo=nuget)](https://www.nuget.org/packages/jcdcdev.Umbraco.ExtendedMarkdownEditor)
+[![Project Website](https://img.shields.io/badge/Project%20Website-jcdc.dev-jcdcdev?style=flat&color=3c4834&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgZmlsbD0id2hpdGUiIGNsYXNzPSJiaSBiaS1wYy1kaXNwbGF5IiB2aWV3Qm94PSIwIDAgMTYgMTYiPgogIDxwYXRoIGQ9Ik04IDFhMSAxIDAgMCAxIDEtMWg2YTEgMSAwIDAgMSAxIDF2MTRhMSAxIDAgMCAxLTEgMUg5YTEgMSAwIDAgMS0xLTF6bTEgMTMuNWEuNS41IDAgMSAwIDEgMCAuNS41IDAgMCAwLTEgMG0yIDBhLjUuNSAwIDEgMCAxIDAgLjUuNSAwIDAgMC0xIDBNOS41IDFhLjUuNSAwIDAgMCAwIDFoNWEuNS41IDAgMCAwIDAtMXpNOSAzLjVhLjUuNSAwIDAgMCAuNS41aDVhLjUuNSAwIDAgMCAwLTFoLTVhLjUuNSAwIDAgMC0uNS41TTEuNSAyQTEuNSAxLjUgMCAwIDAgMCAzLjV2N0ExLjUgMS41IDAgMCAwIDEuNSAxMkg2djJoLS41YS41LjUgMCAwIDAgMCAxSDd2LTRIMS41YS41LjUgMCAwIDEtLjUtLjV2LTdhLjUuNSAwIDAgMSAuNS0uNUg3VjJ6Ii8+Cjwvc3ZnPg==)](https://jcdc.dev/umbraco-packages/extended-markdown-editor)
+
+
+A lightweight custom property editor for Umbraco that sits on top of the default Umbraco.MarkdownEditor.
+
+### Plug and Play
+
+All existing and future properties using Umbraco.MarkdownEditor will automatically use the new editor.
+
+Removing this package will revert to the default Umbraco.MarkdownEditor, **no data loss will occur**.
+
+### Data Type
+
+Extends the configuration to allow control over the transformation of Markdown to HTML
+
+- **Header Offset** - The offset to apply to the header levels
+    - For example: `-1` would transform `# Header 1` to `<h2>Header 1</h2>`
+- **External Links** Open In New Tab - Adds `target="_blank"` to external links
+
+### Property Value Converter
+
+Replaces `IHtmlEncodedString` with `MarkdownValue` which contains the following properties
+
+- **Raw** - The raw markdown as a string
+- **Html** - The transformed HTML value
 - **Markdown** - The Markdig MarkdownDocument
 
-### Data Type
-
-Extends the configuration to allow control over the transformation of Markdown to HTML
+> [!WARNING]
+> Version 12 is no longer supported and is End of Life (EOL).
 
-- **Header Offset** - The offset to apply to the header levels
-    - For example: `-1` would transform `# Header 1` to `<h2>Header 1</h2>`
-- **External Links** Open In New Tab - Adds `target="_blank"` to external links
+> Please review the [security policy](https://github.com/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor?tab=security-ov-file#supported-versions) for more information.
 
-### Plug and Play
-
-All existing and future properties using Umbraco.MarkdownEditor will automatically use the new editor.
-
-Removing this package will revert to the default Umbraco.MarkdownEditor, **no data loss will occur**.
+## Contributing
 
-## Quick Start
+Contributions to this package are most welcome! Please visit the [Contributing](https://github.com/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor/contribute) page.
 
-```csharp
-dotnet add package jcdcdev.Umbraco.ExtendedMarkdownEditor
-```
+## Acknowledgements (Thanks)
 
-## Contributing
+- LottePitcher - [opinionated-package-starter](https://github.com/LottePitcher/opinionated-package-starter)
+- jcdcdev - [jcdcdev.Umbraco.PackageTemplate](https://github.com/jcdcdev/jcdcdev.Umbraco.PackageTemplate)
 
-Contributions to this package are most welcome! Please read
-the [Contributing Guidelines](https://github.com/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor/blob/main/.github/CONTRIBUTING.md).
 
-## Acknowledgments (thanks!)
 
-- LottePitcher - [opinionated-package-starter](https://github.com/LottePitcher/opinionated-package-starter)
-- jcdcdev - [jcdcdev.Umbraco.PackageTemplate](https://github.com/jcdcdev/jcdcdev.Umbraco.PackageTemplate)
diff --git a/SECURITY.md b/SECURITY.md
@@ -0,0 +1,63 @@
+# Security Policy
+
+## Supported Versions
+
+The following table outlines the versions of the project that are currently supported with security & feature updates:
+
+> [!NOTE]
+> Once a version starts its security phase, it will no longer receive feature updates. Only critical bug fixes and security updates will be provided.
+
+| Package Version                                                                            | Umbraco Version | Security Phase Start | End of Life |
+| ---------------------------------------------------------------------------------- | --------------- | -------------------- | ----------- |
+| [10.x](https://github.com/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor/tree/v10) | 10 | 2024-06-16 | 2025-06-16 |
+| [13.x](https://github.com/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor/tree/v13) | 13 | 2025-12-14 | 2026-12-14 |
+| [15.x](https://github.com/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor/tree/v15) | 15 | 2025-08-14 | 2025-11-14 |
+| [16.x](https://github.com/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor/tree/v16) | 16 | 2026-03-12 | 2026-06-12 |
+## Unsupported Versions
+
+| Package Version                                                               |  Umbraco Version  | End of Life |
+| ---------------------------------------------------------------------------------- | ---------------  | ----------- |
+| [12.x](https://github.com/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor/tree/v12) | 12 | 2024-06-29 |
+| [14.x](https://github.com/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor/tree/v14) | 14 | 2025-05-30 |
+
+
+## Future Support
+
+Project maintainers plan to support all STS (Short-Term Support) and LTS (Long-Term Support) versions of Umbraco. However, exact release dates cannot be guaranteed.
+
+> [!NOTE]
+> Visit [jcdc.dev/blog/umbraco-version-information](https://jcdc.dev/blog/umbraco-version-information) for more information on Umbraco versions.
+
+## Reporting a Vulnerability
+
+If you discover a vulnerability in this project, please follow one of these steps to report it:
+
+- Create an [issue](https://github.com/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor/security/advisories/new)
+- Contact the project author privately at [jcdc.dev/contact](https://jcdc.dev/contact)
+
+### Details
+
+Include as much information as possible about the vulnerability, including:
+
+- Steps to reproduce
+- Potential impact
+- Any suggested fixes
+
+### Acknowledgment
+
+You will receive an acknowledgment of your report as soon as possible.
+
+> [!NOTE]
+> Response times may vary depending on other commitments.
+
+### Resolution
+
+Once the vulnerability is confirmed, project maintainers will work to resolve it as quickly as possible.
+
+You will be notified once the issue has been resolved or rejected.
+
+> [!TIP]
+> If the vulnerability is accepted, you will receive credit in the release notes.
+
+Thank you for helping to keep this project secure!
+
diff --git a/docs/README_nuget.md b/docs/README_nuget.md
@@ -1,18 +1,51 @@
 # jcdcdev.Umbraco.ExtendedMarkdownEditor
 
-[![Documentation](https://img.shields.io/badge/Docs-Quickstart-394933?style=flat&logo=github)](https://github.com/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor/tree/main?tab=readme-ov-file#quick-start)
-[![Umbraco Marketplace](https://img.shields.io/badge/Umbraco-Marketplace-%233544B1?style=flat&logo=umbraco)](https://marketplace.umbraco.com/package/jcdcdev.umbraco.extendedmarkdowneditor)
-[![GitHub License](https://img.shields.io/github/license/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor?color=8AB803&label=License&logo=github)](https://github.com/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor/blob/main/LICENSE)
-[![NuGet Downloads](https://img.shields.io/nuget/dt/jcdcdev.Umbraco.ExtendedMarkdownEditor?color=cc9900&label=Downloads&logo=nuget)](https://www.nuget.org/packages/jcdcdev.Umbraco.ExtendedMarkdownEditor/)
+[![Documentation](https://img.shields.io/badge/Docs-Quickstart-394933?style=flat&logo=github)](https://github.com/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor?tab=readme-ov-file#quick-start)
+[![Umbraco Marketplace](https://img.shields.io/badge/Umbraco-Marketplace-%233544B1?style=flat&logo=umbraco)](https://marketplace.umbraco.com/package/jcdcdev.Umbraco.ExtendedMarkdownEditor)
+[![License](https://img.shields.io/github/license/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor?color=8AB803&label=License&logo=github)](https://github.com/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor?tab=MIT-1-ov-file)
+[![NuGet Downloads](https://img.shields.io/nuget/dt/jcdcdev.Umbraco.ExtendedMarkdownEditor?color=cc9900&label=Downloads&logo=nuget)](https://www.nuget.org/packages/jcdcdev.Umbraco.ExtendedMarkdownEditor)
+[![Project Website](https://img.shields.io/badge/Project%20Website-jcdc.dev-jcdcdev?style=flat&color=3c4834&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgZmlsbD0id2hpdGUiIGNsYXNzPSJiaSBiaS1wYy1kaXNwbGF5IiB2aWV3Qm94PSIwIDAgMTYgMTYiPgogIDxwYXRoIGQ9Ik04IDFhMSAxIDAgMCAxIDEtMWg2YTEgMSAwIDAgMSAxIDF2MTRhMSAxIDAgMCAxLTEgMUg5YTEgMSAwIDAgMS0xLTF6bTEgMTMuNWEuNS41IDAgMSAwIDEgMCAuNS41IDAgMCAwLTEgMG0yIDBhLjUuNSAwIDEgMCAxIDAgLjUuNSAwIDAgMC0xIDBNOS41IDFhLjUuNSAwIDAgMCAwIDFoNWEuNS41IDAgMCAwIDAtMXpNOSAzLjVhLjUuNSAwIDAgMCAuNS41aDVhLjUuNSAwIDAgMCAwLTFoLTVhLjUuNSAwIDAgMC0uNS41TTEuNSAyQTEuNSAxLjUgMCAwIDAgMCAzLjV2N0ExLjUgMS41IDAgMCAwIDEuNSAxMkg2djJoLS41YS41LjUgMCAwIDAgMCAxSDd2LTRIMS41YS41LjUgMCAwIDEtLjUtLjV2LTdhLjUuNSAwIDAgMSAuNS0uNUg3VjJ6Ii8+Cjwvc3ZnPg==)](https://jcdc.dev/umbraco-packages/extended-markdown-editor)
+
+
+A lightweight custom property editor for Umbraco that sits on top of the default Umbraco.MarkdownEditor.
+
+### Plug and Play
+
+All existing and future properties using Umbraco.MarkdownEditor will automatically use the new editor.
+
+Removing this package will revert to the default Umbraco.MarkdownEditor, **no data loss will occur**.
+
+### Data Type
+
+Extends the configuration to allow control over the transformation of Markdown to HTML
+
+- **Header Offset** - The offset to apply to the header levels
+    - For example: `-1` would transform `# Header 1` to `<h2>Header 1</h2>`
+- **External Links** Open In New Tab - Adds `target="_blank"` to external links
+
+### Property Value Converter
+
+Replaces `IHtmlEncodedString` with `MarkdownValue` which contains the following properties
+
+- **Raw** - The raw markdown as a string
+- **Html** - The transformed HTML value
+- **Markdown** - The Markdig MarkdownDocument
+
+## Quick Start
+
+```csharp
+dotnet add package jcdcdev.Umbraco.ExtendedMarkdownEditor
+```
 
-A lightweight custom property editor for Umbraco that sits on top of the default Umbraco.MarkdownEditor.
 
 ## Contributing
 
-Contributions to this package are most welcome! Please read
-the [Contributing Guidelines](https://github.com/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor/blob/main/.github/CONTRIBUTING.md).
+Contributions to this package are most welcome! Please visit the [Contributing](https://github.com/jcdcdev/jcdcdev.Umbraco.ExtendedMarkdownEditor/contribute) page.
 
-## Acknowledgments (thanks!)
+## Acknowledgements (Thanks)
 
 - LottePitcher - [opinionated-package-starter](https://github.com/LottePitcher/opinionated-package-starter)
-- jcdcdev - [jcdcdev.Umbraco.PackageTemplate](https://github.com/jcdcdev/jcdcdev.Umbraco.PackageTemplate)
+- jcdcdev - [jcdcdev.Umbraco.PackageTemplate](https://github.com/jcdcdev/jcdcdev.Umbraco.PackageTemplate)
+
+
+
