While Ameliorate is in Alpha, it's expected to change a lot; feel free to mention out-of-date docs, or ideas for improvement
Diagramming Choices

Diagramming Choices

Ameliorate's structure hopefully makes it easier to diagram many situations, but sometimes there are situations where it isn't straightforward how to diagram them. Sometimes you have multiple ways of representing the same information, and it's not easy to tell which way is best. This page describes some of these situations, and possible ways to go about them.

Some situations may also be hard to represent because Ameliorate's ontology (opens in a new tab) does not have the node types to represent the information.

If you have any ideas on potentially-better ways to represent these situations, or you have a situation that you're not sure how to represent, please reach out (opens in a new tab)!

Known tough-to-diagram situations

Multiple variations for one solution

Sometimes a solution can be implemented in different ways, and representing that can be challenging. For example, in the failing-trade-route (opens in a new tab) topic, one way to deal with bandits is to Bait & Ambush them, but such a thing can be done many ways! Perhaps this could be accomplished using a local militia, or by hiring guards, or by training villagers to help, or some combination of these. We could even discuss hiring 20 guards vs hiring 40 guards vs hiring another number of guards - when you can make variations by just changing numbers, there are an infinite number of possibilities!

If it seems reasonable to discuss these possibilities without going into detailed tradeoffs, the simplest thing is to just represent each variable as a solution component, like this (opens in a new tab). The solution might not actually use all of these components, but they at least exist in the diagram for discussion.

If there are multiple variables that can be adjusted for a solution, and you want to consider multiple variations across each of those variables, then you can create a problem for each variable, with a solution for each variation. For example, a problem "ambushing bandits with whom" could have solutions that each convey a different set of people to use for the ambush. See this example (opens in a new tab).

If you don't care to consider each variable individually, but you still want to discuss the best variation, then you can make a problem like "best way to ambush bandits", with solutions for each set of ways to do the ambush - see this example (opens in a new tab).

If there are only a couple variations you care to consider, you could treat each as a distinct solution to the original problem. See this example (opens in a new tab).

Some ideas for changing Ameliorate's structure to improve this, but that haven't been thoroughly considered: add an Option node type; allow any node type to be an option for another related node; add variables with discrete possible values as a new kind of information that any node can have.

Refactoring tools

Choices are hard. So there are a couple of features that are available to help it easy to switch between choices:

  • change node type
  • create criterion from cause (doesn't exist yet)
  • create detriment from claim (doesn't exist yet)