ABIF: Difference between revisions

Content added Content deleted
(Cleaned up formatting, and finished linking to current test cases. This will be an informative list, pointing to the normative copy on GitHub.)
(Updating the ABIF page here on electowiki)
Line 1:
'''ABIF''' stands for "aggregated ballot information format"<ref>https://github.com/electorama/abif/issues/2</ref>. As of MayIn 2021, it has been undergoing discussion on the /r/[[EndFPTPUser:RobLa]] subredditstarted anda onGitHub repo under the "[[EM-listElectowiki:Electorama!|Electorama!]].<ref" name="EM-post-2788">http://listsbranding.electorama.com/pipermail/election-methods-electorama.com/2021-May/002788.html</ref><ref{{Cite nameweb|url="robla-comment-reddit-2020-05-26">https://www.redditgithub.com/relectorama/EndFPTP/comments/nkm2cd/standardizing_cardinal_ballot_notation/gzls6pj/</ref><ref>http://lists.electoramaabif|title=github.com/pipermail/election-methods-electorama.com/2021abif|url-May/002789.htmlstatus=live}}</ref>
 
== Discussions ==
The discussions about ABIF have been happening in several places:
 
* In May 2021, the main discussions were on the /r/[[EndFPTP]] subreddit and on the [[EM-list]].<ref name="EM-post-2788">http://lists.electorama.com/pipermail/election-methods-electorama.com/2021-May/002788.html</ref><ref name="robla-comment-reddit-2020-05-26">https://www.reddit.com/r/EndFPTP/comments/nkm2cd/standardizing_cardinal_ballot_notation/gzls6pj/</ref><ref>http://lists.electorama.com/pipermail/election-methods-electorama.com/2021-May/002789.html</ref>
* In June 2021, the discussions shifted over to the EM-list, and then mostly on the GitHub issue tracker.<ref name=":0">{{Cite web|url=https://github.com/electorama/abif/issues|title=electorama/abif issue tracker on GitHub|url-status=live}}</ref><ref name=":1">{{Cite web|url=https://github.com/electorama/abif/issues?q=is%3Aissue+is%3Aclosed|title=electorama/abif closed issues on GitHub|url-status=live}}</ref>
* In July 2021, conversations were dying down, but then [[User:RobLa]] published an [[W:EBNF|EBNF]] file describing ABIF. More activity occurred on GitHub.<ref name=":0" /><ref name=":1" />
* By August 2021, conversations mostly shifted over to GitHub. [[User:RobLa]] opened [https://github.com/electorama/abif/discussions the "Discussions" area on electorama/abif on GitHub], and provided an update on the project.<ref>{{Cite web|url=https://github.com/electorama/abif/discussions/18|title=August 2021 progress on ABIF|last=Lanphier|first=Rob|date=2021-08-28|website=electorama/abif on github.com|url-status=live}}</ref>
 
== Details ==
ABIF uses the [https://en.wikipedia.org/wiki/UTF-8 UTF-8] character encoding.
 
== Test cases ==
 
The normative set of test cases are on GitHub, and we'll be expanding them there. Among the things we want to test for<ref>http://lists.electorama.com/pipermail/election-methods-electorama.com/2021-June/002793.html</ref>
 
* Case #1: Unordered scores on a bundle line.<ref>https://github.com/electorama/abif/blob/main/testfiles/test001.abif</ref>
*Case #2: Unscored (but ranked) candidates delimited only by ">" and "=".<ref>https://github.com/electorama/abif/blob/main/testfiles/test002.abif</ref>
*Case #3: Ranked ''and'' rated candidates.<ref>https://github.com/electorama/abif/blob/main/testfiles/test003.abif</ref>
*Case #4: Bracketed, inlined candidate tokens with many "high UTF-8" characters, like "ñ", "í", "á", "蘇","業".<ref>https://github.com/electorama/abif/blob/main/testfiles/test004.abif</ref>
*Case #5: Declared candidate tokens, with unordered scores.<ref>https://github.com/electorama/abif/blob/main/testfiles/test005.abif</ref>
*Case #6: Declared candidate tokens, ranked and scored.<ref>https://github.com/electorama/abif/blob/main/testfiles/test006.abif</ref>
*Case #7: Bracketed candidate tokens (declared), ranked with no score.<ref>https://github.com/electorama/abif/blob/main/testfiles/test007.abif</ref>
*Case #8: Bracketed candidate tokens (mixed), ranked with no score and most extra whitespace removed.<ref>https://github.com/electorama/abif/blob/main/testfiles/test008.abif</ref>
*Case #9: Asterisk-delimited multiplier, suggested by Jan Šimbera in May 2020.<ref>https://github.com/electorama/abif/blob/main/testfiles/test009.abif</ref><ref>http://lists.electorama.com/pipermail/election-methods-electorama.com/2021-June/002793.html</ref>
==Footnotes==
<references />