code the 'pede

What's the point of structured data if you're not progammatically interacting with it? We encourage you to add facts, review changes, query the datastore, play around. Have any questions or comments? Email me at saunders-at-casegame-dot-com.

adding facts

You can add up to 100 facts at a time by posting text to the add facts page. Post data is treated as a collection of facts, one fact per line, four tab-delimited (escape your wacks and tabs and newlines with backslashes) fields per fact (vote,left,relation,right). For example:

% cat facts.txt
# this is a comment
1   rock        beats               scissors
1   scissors    beats               paper
1   paper       beats               rock
0   rock        beats               everthing
1   rock        between me and a    hard place
% curl --data-binary @facts.txt http://www.millipedia.org/_add
5 votes added.

A vote is either "1" (up), or "0" (down). Note that voting is the same as adding a fact.

getting facts

Add a "format=text" to a fact's URL to get a fact in plain text. For example:

% curl "http://www.millipedia.org/rock?format=text"
2       3       rock    beats   scissors
2       2       paper   beats   rock
1       2       rock    beats   everything
1       1       rock    between me and a   hard place

The first column is sum of up votes, the second column is the total number of votes, followed by the left, relation, and right fields.

fact history

Review facts history, so that you can correct incorrect votes. Again, add a "format=text" to a fact history's URL to get plain text. E.g.:

l:beats scissors|1|2008-04-09T18:27:51Z,66.7.243.130    Mozilla/5.0 (Macintosh; U; PPC Mac OS X Mach-O; en-US; rv:1.8.1.13) Gecko/20080311 Firefox/2.0.0.13
r:beats paper|1|2008-04-09T18:27:34Z,127.0.0.1  Mozilla/5.0 (Macintosh; U; PPC Mac OS X Mach-O; en-US; rv:1.8.1.13) Gecko/20080311 Firefox/2.0.0.13

Two columns, the first is the relation and the direction ("l:" means left, "r:" means right), the second is the target noun, the vote delta, and the author of the change, delimited by bars ("|").

future work

Some of the ideas for future work:

• nightly changes uploaded to a public S3 bucket
• arbitrary queries
• fuzzy logic

Thanks, now go forth and assert your facts!