From 482333b263a855e204950f04d0dd5ec57fefbe97 Mon Sep 17 00:00:00 2001 From: Jeremy Saklad Date: Sat, 11 Sep 2021 16:14:35 -0500 Subject: [PATCH] Add Versioning section to README This section outlines explicit conformance to Semantic Versioning 2.0.0, and outlines the public API. It also introduces a tag pattern for determining whether the solver reflects the desired state of Fallen London. --- README.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/README.md b/README.md index 0de87b2..d9b3f6c 100644 --- a/README.md +++ b/README.md @@ -71,6 +71,14 @@ Configuration files are read top-to-bottom. Arguments can be delimited by a sing Any number of configuration files may be provided simultaneously. +## Versioning + +This tool follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html). The public API consists of the command-line interface, as well as all public Python declarations. + +As Fallen London is a living game, the solver may not reflect its present state. With that in mind, version tags include the last known date of relevant changes to Fallen London that are reflected by the tool. Any changes to Fallen London since that date, even if they were made before the tag or commit, should be presumed unimplemented. + +While all commits in the main branch are functional, unversioned commits should not be considered *accurate*. They may, for instance, partially incorporate an update to Fallen London, which results in a solver that does reflect the game at any single point in time. Pre-release versions should be considered on case-by-case basis: a pre-release may accurately reflect only a subset of the Bone Market, constraining the solver to avoid options that are no longer correctly evaluated. + ## Caveats The solver aims to maximize profit margin, rather than sheer profit. This is because it may be more profitable to make many smaller skeletons than one massive skeleton.