6 days agoEnforcing API and Data Model design rules with SpecrtalJargon can automatically real-time validate your APIs and Data Models according to a set of custom defined rules, using the open-source Spectral rule language. These rules can be used to check a variety of facets of your designs, such as: simplistic style rules, such as the casing of classes and…API5 min readAPI5 min read
Sep 19Creating JSONSchema with JargonJargon can export select Classes from your Domain as JSONSchema, which you can then import into downstream tools or integrate into your development processes. Let’s take a look at how to do it: Jargon forces separation between the structure of your Domain (the textual representation of your model) from its…Json Schema4 min readJson Schema4 min read
Sep 13Advanced API Data Modelling Techniques with JargonBy visually designing the data that your API will use, Jargon lets you apply some advanced modelling techniques that help you clearly describe how everything hangs together, letting you tell a clearer and business-oriented story. Here is the Domain and rendered API Specification that we will be going through in…API5 min readAPI5 min read
Aug 21Designing Hypermedia and State Lifecycle Driven APIs with JargonJargon is a platform for creating data models and APIs using Domain Driven Design. In this article we’ll: create a state lifecycle that will advertise what actions can be taken on a Shopping Cart using the states from the lifecycle as the status code for a the Shopping Cart resource …API6 min readAPI6 min read
Aug 1Jargon for JSON-LD — A worked example using schema.orgJargon is a platform for creating data models and APIs using Domain Driven Design. We’ve recently added the ability to export your Domains as JSON-LD vocabularies. Let’s take a look at how to do it. What we will be creating For this example, we will be recreating the PetStore example from Swagger, but will leverage…Json Ld4 min readJson Ld4 min read
Jul 31Introducing Jargon — Creating a ReadmeDocumenting your Domains with 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 readme is a page that Jargon hosts for you that you can customise to explain the ins and outs of your…Ddd4 min readDdd4 min read
Jun 13A worked example of using Jargon for Domain Driven Design — Part 3Welcome to Part 3 of using Jargon for Domain Driven Design. In this article, we will create two Domains from the Town Plan created in Part 2. This will give you a taste of Town Plan driven development, which involves iteratively creating Domains, and using those to design others. Which Domain should we start with? This…Domain Driven Design5 min readDomain Driven Design5 min read
Jun 13A worked example of using Jargon for Domain Driven Design — Part 2Welcome to Part 2 of using Jargon for Domain Driven Design. In this article, we will create a Town Plan from the conceptual model in Part 1. …Domain Driven Design4 min readDomain Driven Design4 min read
Jun 11A worked example of using Jargon for Domain Driven Design — Part 1Domain Driven Design (DDD) is a very powerful technique for breaking down large and complex systems into smaller more manageable chunks. But, it can be tricky to get started and even harder to manage over time. That’s what Jargon helps with. It is a platform that helps you and your…Domain Driven Design6 min readDomain Driven Design6 min read
Sep 11, 2022An iterative approach to Data and API managementIn this next part of my ongoing series on Jargon, which you can read in full here, I’ll be going over how all of Jargon fits together to deliver an iterative approach to managing Data Models and APIs. Here’s an overview of what we’ll be going over in this post:Data5 min readData5 min read
