-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Simplified the walls of text. Removed unused files.
- Loading branch information
Tim Hutton
committed
Jan 22, 2015
1 parent
800474a
commit 3c7a1a7
Showing
6 changed files
with
26 additions
and
218 deletions.
There are no files selected for viewing
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,47 +1,42 @@ | ||
Kitti is the Tongs’ system for keeping track of who paid for what and ensuring everything is fair (over time). No money changes hands between participants until they want to stop using Kitti. | ||
Kitti is a system for keeping track of who paid for what and ensuring everything is fair (over time). No money changes hands between participants until they want to stop using Kitti. | ||
|
||
Browse… | ||
------- | ||
|
||
- The current status, for easy consulting in restaurants, petrol/train stations and water parks, may be consulted instantaneously [using a JavaScript viewer][]. | ||
- [The transaction log][] and [letter/name mapping][] as raw text. | ||
- [The HOWTO][] for this game (of minor interest and — like anything with the Tongs — subject to change without reason). | ||
- [The source code of the script][] from [the GitHub repository][], for the intrepid and foolhardy. Remember though, like with [Bitcoin][], Kitti is not the script. Kitti is the transaction log. | ||
The [current dashboard][] is automatically generated from the [transaction log][] and [letter/name mapping][] | ||
|
||
Edit… | ||
----- | ||
|
||
In the future we’ll allow people to add transactions via SMS, Twitter, etc. In the meantime, you must be logged into GitHub and be listed as a contributor to the repository in order to [edit the transaction log][] or to [edit the letter/name mapping][]. | ||
Maybe in the future we’ll allow people to add transactions via SMS, Twitter, etc. In the meantime, you must be logged into GitHub and be listed as a contributor to the repository in order to [edit the transaction log][] or to [edit the letter/name mapping][]. | ||
|
||
Examples: | ||
--------- | ||
|
||
transaction | meaning | ||
------------------------|--------------------------------------------------------------------------------------------------- | ||
A,B,C:20C dinner | Amy, Ben and Cecilia had dinner that cost 20ukp. Cecilia paid 20ukp. | ||
C(50%),B:90A shoes | Cecilia and Ben got shoes. Cecilia's shoes were half the price of Ben's. Amy paid 90ukp. | ||
B,A(4.60):10A tickets | Ben and Amy got tickets. Amy's ticket was 4.60ukp. Amy paid 10ukp. | ||
C,B:22.50B,18.00C dinner| Cecilia and Ben had dinner. Ben paid 22.50ukp. Cecilia paid 18ukp. | ||
|
||
We put the date in front to keep track of things. See the [transaction log][] and [letter/name mapping][] for more examples. | ||
|
||
History and lore | ||
---------------- | ||
Fork… | ||
----- | ||
|
||
Kitti has been in development since 2006. The Tongs wiki contained a [conversation about communal costs][] where Fergal explains: | ||
If you want to use Kitti for shared expenses but don't want to be part of our network then just [fork][] the project and delete the entries to start afresh. You will need to also update the links in this README document. | ||
|
||
> KITTI’s methodology is very simple — she will look at what everyone has spent and where a tong has not benefitted from an expense, their own expenses will be increased to offset the difference. The average of the actual expenses is then calculated and the difference between offset expenses and the average will equal what is owing. | ||
Who is Kitti? | ||
------------- | ||
|
||
The setting then was for a single trip with fixed participants. By comparison, in this setting, the balance shown in the new Kitti reflects this difference, but running continually and among a wider group, who don’t necessarily all meet together. | ||
We asked a child. They produced this: | ||
|
||
[According to lore][], the name Kitti was invented following an argument about a communal kitty during a snowboarding trip in 2006. Essentially, the argument was resolved by choosing a new name for the communal costs system described above. Afterwards, a spreadsheet was developed by Fergal, Nugget and others, which did the work of the script we use today. Kitti is in fact an acronym, which, since Monkey’s rapid decision on the matter, stands for *Klau’s Intricate Transactions Totting Index*. | ||
![kitti drawing](https://raw.githubusercontent.com/rawles/kitti/gh-pages/kitti.jpg) | ||
|
||
These Excel spreadsheets ([kitti.xls][], [newkitti.xls][]) reveal that Kitti was the name of an ancient demon goddess resurrected from the bowels of hell to wreak vengeance, but lost in the internet and trapped in these spreadsheets. You don’t need to know about this to use Kitti. | ||
They told us that Kitti has a very long nose. A waggy tail. Bulging eyes to see in the dark. A bump on their head. And a big tummy. | ||
|
||
[using a JavaScript viewer]: http://rawles.github.io/kitti/ | ||
[The transaction log]: https://raw.githubusercontent.com/rawles/kitti/gh-pages/kittilog.txt | ||
[current dashboard]: http://rawles.github.io/kitti/ | ||
[transaction log]: https://raw.githubusercontent.com/rawles/kitti/gh-pages/kittilog.txt | ||
[letter/name mapping]: https://raw.githubusercontent.com/rawles/kitti/gh-pages/names.txt | ||
[The HOWTO]: HOWTO.md | ||
[The source code of the script]: https://github.com/rawles/kitti/blob/gh-pages/kitti.pl | ||
[the GitHub repository]: https://github.com/rawles/kitti/ | ||
[Bitcoin]: https://bitcoin.org/en/ | ||
[edit the transaction log]: https://github.com/rawles/kitti/edit/gh-pages/kittilog.txt | ||
[edit the letter/name mapping]: https://github.com/rawles/kitti/edit/gh-pages/names.txt | ||
[conversation about communal costs]: https://web.archive.org/web/20080109231307/http://www.tongs.org.uk/wiki.pl?CommunalCosts | ||
[According to lore]: https://web.archive.org/web/20080109231307/http://www.tongs.org.uk/wiki.pl?Kitti | ||
[kitti.xls]: https://web.archive.org/web/20080109231307/http://www.tongs.org.uk/files/kitti.xls | ||
[newkitti.xls]: https://web.archive.org/web/20080109231307/http://www.tongs.org.uk/files/newkitti.xls | ||
|
||
Turtle drew this picture of Kitti for us: | ||
----------------------------------------- | ||
![kitti drawing](https://raw.githubusercontent.com/rawles/kitti/gh-pages/kitti.jpg) | ||
[fork]: https://github.com/rawles/kitti/fork | ||
|
||
And told us that Kitti has a very long nose. A waggy tail. Bulging eyes to see in the dark. A bump on their head. And a big tummy. |
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.