Schema: The Art of Describing Abstract Data - Revision history

Dex: /* A Small Problem */

2026-07-03T12:52:33Z

A Small Problem

← Older revision		Revision as of 12:52, 3 July 2026
Line 15:		Line 15:
	Consider the following JSON document:		Consider the following JSON document:

	<~~syntaxhighlight lang="json"~~>		<pre>
	{		{
	"A": 52,		"A": 52,
Line 21:		Line 21:
	"C": 3		"C": 3
	}		}
	</~~syntaxhighlight~~>		</pre>

	It is valid JSON.		It is valid JSON.

Dex at 12:46, 3 July 2026

2026-07-03T12:46:25Z

@@ Line 208: / Line 208: @@
 A schema transforms values into knowledge.
 == Schema as a Form Template ==
@@ Line 320: / Line 291: @@
 In other words, a schema documents the language spoken by the data.
 == The Real Lesson ==

Dex: /* Schema as a Form Template */

2026-07-03T12:42:20Z

Schema as a Form Template

← Older revision		Revision as of 12:42, 3 July 2026
Line 239:		Line 239:

	== Schema as a Form Template ==		== Schema as a Form Template ==

			Another useful way to think about a schema is as a form.

			Consider the following paper form:

			<pre>
			First Name: ____________

			Last Name: ____________

			Date of Birth: ____________

			Email Address: ____________
			</pre>

			Although the form contains no data, it already tells us a great deal.

			It tells us:

			* What information is expected
			* Where that information belongs
			* How the information is organised
			* What each value represents

			The form is acting as a schema.

			Now imagine somebody completes the form:

			<pre>
			First Name: Dex

			Last Name: White

			Date of Birth: ____________

			Email Address: dex@example.com
			</pre>

			The values have been added, but the structure has not changed.

			The form already defined the meaning of each field before any data was entered.

			If we look closely, every completed field contains two parts:

			<pre>
			First Name: Dex
			^^^^^^^^^^ ^^^
			Schema Data
			</pre>

			The label on the left describes the value on the right.

			This is exactly what a schema does.

			Without the label, the value is merely text.

			With the label, the value becomes information.

			The same principle applies to databases, APIs, XML documents, JSON documents and paper forms.

			The schema defines what information can exist.

			The data provides the values.

			Together they create meaning.

	== More Than Validation ==		== More Than Validation ==

Dex at 12:40, 3 July 2026

2026-07-03T12:40:12Z

← Older revision		Revision as of 12:40, 3 July 2026
Line 237:		Line 237:

	Schemas perform exactly the same role for data.		Schemas perform exactly the same role for data.

			== Schema as a Form Template ==

	== More Than Validation ==		== More Than Validation ==

Dex: /* Schema: The Art of Describing Abstract Data */

2026-07-03T12:31:00Z

Schema: The Art of Describing Abstract Data

← Older revision		Revision as of 12:31, 3 July 2026
Line 1:		Line 1:
	~~= Schema: The Art of Describing Abstract Data =~~

	== Summary ==		== Summary ==

Dex: Created page with "= Schema: The Art of Describing Abstract Data = == Summary == Data is easy to store, transmit and process. Understanding what that data means is much harder. A schema is more than a validation mechanism. It is a description of meaning. It provides a shared vocabulary that allows humans and systems to interpret abstract data consistently. Whether expressed through XML Schema, JSON Schema, database definitions, API specifications or even paper forms, a schema exists to..."

2026-07-03T12:30:45Z

Created page with "= Schema: The Art of Describing Abstract Data = == Summary == Data is easy to store, transmit and process. Understanding what that data means is much harder. A schema is more than a validation mechanism. It is a description of meaning. It provides a shared vocabulary that allows humans and systems to interpret abstract data consistently. Whether expressed through XML Schema, JSON Schema, database definitions, API specifications or even paper forms, a schema exists to..."

New page

= Schema: The Art of Describing Abstract Data =

== Summary ==

Data is easy to store, transmit and process. Understanding what that data means is much harder.

A schema is more than a validation mechanism. It is a description of meaning. It provides a shared vocabulary that allows humans and systems to interpret abstract data consistently.

Whether expressed through XML Schema, JSON Schema, database definitions, API specifications or even paper forms, a schema exists to answer a simple question:

''What does this data actually represent?''

----

== A Small Problem ==

Consider the following JSON document:

<syntaxhighlight lang="json">
{
"A": 52,
"B": 1,
"C": 3
}
</syntaxhighlight>

It is valid JSON.

A parser can read it.

A computer can store it.

But what does it mean?

Nothing in the document tells us.

The computer knows:

<pre>
A is a number.
B is a number.
C is a number.
</pre>

But it does not know what those numbers represent.

Neither do we.

Without context, the data is almost meaningless.

== Schema Version 1 - Playing Cards ==

A schema tells us:

<pre>
A = Card Value
B = Suit
C = Number of Cards
</pre>

and:

<pre>
Suit:
1 = Hearts
2 = Diamonds
3 = Clubs
4 = Spades
</pre>

Suddenly:

<syntaxhighlight lang="json">
{
"A": 52,
"B": 1,
"C": 3
}
</syntaxhighlight>

becomes:

<pre>
Three cards from the Hearts suit.
Highest card value 52.
</pre>

Not especially exciting, but meaningful.

The values have not changed.

Only our understanding has changed.

== Schema Version 2 - Aircraft ==

Now imagine a different schema:

<pre>
A = Altitude (Thousands of Feet)
B = Aircraft Status
C = Engine Count
</pre>

and:

<pre>
Aircraft Status:
1 = In Flight
2 = Grounded
3 = Taxiing
</pre>

The exact same JSON now becomes:

<pre>
Aircraft flying at 52,000 feet
with three engines.
</pre>

The data is identical.

The meaning is completely different.

== Schema Version 3 - A Hospital ==

Now consider a hospital system.

The schema defines:

<pre>
A = Patient Age
B = Priority
C = Ward
</pre>

and:

<pre>
Priority:
1 = Critical
2 = Urgent
3 = Routine
</pre>

The same data becomes:

<pre>
52-year-old patient.
Critical priority.
Ward 3.
</pre>

Once again, nothing in the JSON changed.

Only the schema changed.

== Beyond Simple Definitions ==

Modern systems rarely stop at simple field definitions.

A schema may define:

<pre>
Field Names
Data Types
Relationships
Constraints
Documentation
Validation Rules
Units
Permitted Values
</pre>

So the same data might expand into:

<pre>
Patient Record
├── Age: 52 Years
├── Priority: Critical
└── Ward: Cardiology
</pre>

or:

<pre>
Aircraft Telemetry
├── Altitude: 52,000 Feet
├── Status: In Flight
└── Engines: 3
</pre>

or:

<pre>
Inventory Item
├── Quantity: 52
├── Warehouse: London
└── Shelf: 3
</pre>

The schema transforms simple values into structured information.

== The Schema Does Not Hold Data ==

A common misconception is that schemas describe data.

In reality, the data already exists.

The schema describes how the data should be interpreted.

A schema transforms values into knowledge.

== The Map Legend ==

Perhaps the simplest way to think about a schema is as a map legend.

Without the legend:

<pre>
▲ ● ■ ★
</pre>

the symbols are meaningless.

With the legend:

<pre>
▲ Mountain
● Town
■ Railway Station
★ Capital City
</pre>

an entire landscape appears.

The symbols have not changed.

Your understanding has.

Schemas perform exactly the same role for data.

== More Than Validation ==

Many technologies use schemas to validate documents.

A good schema also explains:

<pre>
What fields exist
What those fields represent
How they relate
What values are permitted
What assumptions are being made
</pre>

In other words, a schema documents the language spoken by the data.

== The Real Lesson ==

Whether using XML, JSON, YAML, CSV, relational databases or paper forms, the underlying problem is unchanged.

The data itself rarely explains its own meaning.

Meaning emerges from shared understanding.

A schema records that understanding.

It defines the vocabulary, the relationships and the assumptions that allow abstract values to become useful information.

A schema is not merely a validation tool.

It is a way of describing the world represented by the data.

Perhaps the most important lesson XML ever taught us is this:

''Data tells us the value. A schema tells us what the value means.''