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: | Line 1: | ||
'''ABIF''' stands for "aggregated ballot information format"<ref>https://github.com/electorama/abif/issues/2</ref>. |
'''ABIF''' stands for "aggregated ballot information format"<ref>https://github.com/electorama/abif/issues/2</ref>. In 2021, [[User:RobLa]] started a GitHub repo under the "[[Electowiki:Electorama!|Electorama!]]" branding.<ref>{{Cite web|url=https://github.com/electorama/abif|title=github.com/electorama/abif|url-status=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. |
ABIF uses the [https://en.wikipedia.org/wiki/UTF-8 UTF-8] character encoding. |
||
== Test cases == |
== Test cases == |
||
The normative set of test cases are on GitHub, and we'll be expanding them there. |
The normative set of test cases are on GitHub, and we'll be expanding them there.<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== |
==Footnotes== |
||
<references /> |
<references /> |
Revision as of 03:43, 30 August 2021
ABIF stands for "aggregated ballot information format"[1]. In 2021, User:RobLa started a GitHub repo under the "Electorama!" branding.[2]
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.[3][4][5]
- In June 2021, the discussions shifted over to the EM-list, and then mostly on the GitHub issue tracker.[6][7]
- In July 2021, conversations were dying down, but then User:RobLa published an EBNF file describing ABIF. More activity occurred on GitHub.[6][7]
- By August 2021, conversations mostly shifted over to GitHub. User:RobLa opened the "Discussions" area on electorama/abif on GitHub, and provided an update on the project.[8]
Details
ABIF uses the UTF-8 character encoding.
Test cases
The normative set of test cases are on GitHub, and we'll be expanding them there.[9]
Footnotes
- ↑ https://github.com/electorama/abif/issues/2
- ↑ "github.com/electorama/abif".
- ↑ http://lists.electorama.com/pipermail/election-methods-electorama.com/2021-May/002788.html
- ↑ https://www.reddit.com/r/EndFPTP/comments/nkm2cd/standardizing_cardinal_ballot_notation/gzls6pj/
- ↑ http://lists.electorama.com/pipermail/election-methods-electorama.com/2021-May/002789.html
- ↑ a b "electorama/abif issue tracker on GitHub".
- ↑ a b "electorama/abif closed issues on GitHub".
- ↑ Lanphier, Rob (2021-08-28). "August 2021 progress on ABIF". electorama/abif on github.com.
- ↑ http://lists.electorama.com/pipermail/election-methods-electorama.com/2021-June/002793.html