Initial commit

2026-05-27 10:27:16 +01:00
commit a2b0d13e2c
1 changed files with 52 additions and 0 deletions
@@ -0,0 +1,52 @@
+# Palette Format Specification
+
+This repository contains the specification for the Palette XML format, a simple
+format for representing colour palettes.
+
+## Overview
+
+The Palette format is an XML vocabulary for representing a collection of named
+colours. Each colour entry carries a name and component values for red, green,
+blue, and opacity.
+
+## Namespace
+
+The XML namespace for this format is:
+
+```
+http://markembling.info/xmlschema/colourchooser/palette/1
+```
+
+This namespace identifies version 1 of the format. A new namespace will be
+introduced only if a future version of the format introduces breaking changes.
+Backwards-compatible additions do not result in a new namespace.
+
+## Versioning
+
+This specification follows [Semantic Versioning](https://semver.org/):
+
+- **Major** version increments correspond to breaking changes and introduce a new namespace.
+- **Minor** version increments correspond to backwards-compatible additions to the format.
+- **Patch** version increments correspond to corrections to the schema or specification
+  documents where the format itself has not changed.
+
+The current version is indicated by the `version` attribute on the root `xs:schema`
+element of [`palette.xsd`](palette.xsd).
+
+Git tags correspond directly to specification versions and are prefixed with `v`
+(e.g. `v1.0.0`, `v1.1.0`).
+
+## Licence
+
+This specification is copyright Mark Embling and is licensed under
+[Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)](https://creativecommons.org/licenses/by-sa/4.0/).
+
+You are free to share and adapt the specification for any purpose, provided you give
+appropriate attribution and distribute any derivative specifications under the same licence.
+
+### Implementing this Specification
+
+Implementing this specification in software — including commercial software — is
+explicitly permitted without restriction. The licence terms do not extend to
+implementations; only to the specification document itself and works derived
+from it.