Designing Hypermedia and State Lifecyle Driven APIs
Bring some rich behaviour to your APIs by modelling how your business resources behave.
Posts by Year
2023
Authoring JSON-LD. A worked example using schema.org
JSON-LD is the standard way to link data to your APIs using standard vocabularies. Let’s take a look at how to do it.
Creating a README
Once you’ve created your Domain in Jargon, you will want some way to document it for others to discover and understand — that’s were a Readme comes in.
A Worked Example of using Jargon for Domain Driven Design - Part 3
Iteratively creating Domains on the Town Plan helps to reuse and leverage work across the enterprise.
A Worked Example of using Jargon for Domain Driven Design - Part 2
Creating a Town Plan based on our conceptual model will help us plan how Domains will evolve over time.
A Worked Example of using Jargon for Domain Driven Design - Part 1
Domain Driven Design (DDD) is a very powerful technique for breaking down large and complex systems into smaller more manageable chunks.
2022
An Iterative Approach to API and Data Management
Jargon can deliver an iterative approach to managing Data Models and APIs.
Creating OpenAPI Specifications
Jargon helps you create OpenAPI specifications from your domain models, and I’m going to show you just how quick and easy it is to do.
2021
Town Plan Driven Development
A Jargon TownPlan helps you quickly see how your domains are connected, and what their major resources are.
Creating Releases and Importing Domains
A Release is an unchangeable version of your domain that is made available to other people to use.
Modelling Data
If you’ve been following along in this series, you should now know what a Domain is in Jargon, and how how to create and save them.
Creating your first Domain
There’s nothing worse then starting new for the first time and being presented with a blank-page and no information on what to do.
A collaborative platform for data modelling and vocabulary development
Hello! If you’re into data modelling or vocabulary development, let me introduce you to Jargon.