Code is law: Yours.org fees and prices specified in pseudocode
I have published on GitHub here a mock-up of how I would love the team at Yours.org to publish the rules by which the fees and prices on the system are set and transacted. It uses pseudocode that is intended to be strictly unambiguous, making it suitable to be used as a reference for both the Yours.org team and its users, in case they decided to use it.
The top ~50 lines of pseudocode look a bit like this:
I've had the idea while reading Yours.org's "About" page some time ago, as soon as I bumped into the first ambiguity caused by trying to express the rules in conversational English. I'm not English mother-tongue, but I've been living in London, UK, for many years, so I don't think it's me being dumb 😁 nor it's Yours.org team's fault: natural language is just weak at describing that kind of dynamics.
Publishing the rules using a public GitHub repository has a lot of advantages:
- it would allow Yours.org to be absolutely transparent and unambiguous about the rules - particularly if pseudocode was developed further and made into actual code, integrated in their system's code;
- it creates a space for a more open and systematic discussion of the rules than possible on Slack, e.g. by proposing changes using pull requests, discussing them in GitHub's "Issues" forum, etc.
- it creates a historical record of what the rules were in the past.
I hope my work was useful, and look forward to Yours.org team's and your feedback.
- I am not associated to the team at Yours.org, however I have been advising them informally, through their Slack channel and in private sessions. My work was reverse-engineered from observing the public features of the website only, and reading its documentation, and is not built on any confidential information I got from the team.