# 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.