Slashdot Mirror


Washington DC Made GitHub Its Official Digital Source For Laws (arstechnica.com)

"Recently, I found a typo in the District of Columbia's legal code and corrected it using GitHub," writes D.C. based "civic hacker" Joshua Tauberer, adding "My feat highlights the groundbreaking way the District manages its legal code." The District does something with its legal code that no other jurisdiction in the world does (to my knowledge): it publishes the law on GitHub.... This isn't a copy of the DC law. It is an authoritative source. It is where the DC Council stores the digital versions of enacted laws, and this source feeds directly into the Council's DC Code website.... This is a milestone in the advancement of open government and open legal publishing.

No one should expect that editing the law on GitHub is going to become the new normal, however. My edit wasn't substantive. This sort of "technical correction," as lawyers would call it, didn't need to be passed by the Council and signed by the Mayor. I also happen to have expertise in this particular law, GitHub, XML, and the Council's new publishing process created by the Open Law Library.... GitHub's pull-request feature isn't going to replace public hearings, expert testimony, negotiations between stakeholders, votes by elected representatives, etc. -- and it shouldn't. Yet Open Law Library's new legal publishing process is groundbreaking. The Open Law Library is changing how we change the law...

Open Law Library's mission as a nonprofit is to make all laws as open and accessible as possible. The library's strategy is to achieve openness by making openness pay off for governments: it uses open, machine-readable laws to build software tools that make codification faster and more accurate. The cool thing about this is that governments can benefit from using Open Law Library's software even if open data isn't their highest priority, but in the background they'll still be publishing their laws in an open and accessible format -- everybody wins. Today, instead of authoring the DC Code in Word documents stored on a hard drive in a locked room in a basement, the Code is now stored in XML format in a place everyone can see -- on the Web."

The article notes that 18 more states have now enacted "Uniform Electronic Legal Material Acts" -- and that several other jurisdictions are already publishing their legal codes with official bulk XML downloads. "The US federal government began publishing XML downloads for the Code of Federal Regulations in 2009 and the United States Code in 2013."

But the District of Columbia "appears to be the first jurisdiction to combine the two by putting its legal code on GitHub and accepting a change from a member of the public."

66 comments

  1. So in other words... by Anonymous Coward · · Score: 0

    Microsoft controls the law now. Good times...

    1. Re:So in other words... by Anonymous Coward · · Score: 0

      The anus is the opening at the end of the digestive tract where stool leaves the body. The rectum is the section of the digestive tract above the anus where stool is held before it passes out of the body through the anus.

    2. Re:So in other words... by michelcolman · · Score: 1

      I wonder what would happen if they made it a wiki instead of using github. Just let anyone edit the laws as they see fit, and get rid of congress.

    3. Re:So in other words... by Anonymous Coward · · Score: 0

      Companies would hire people established in the hierarchy to edit laws as they liked. Regulatory capture.

      So, basically, we'd be back to normal in no time.

  2. Buying the Law by Anonymous Coward · · Score: 0

    And since Microsoft will soon own Github, you could say Microsoft is finally directly buying the law.

    1. Re:Buying the Law by darkain · · Score: 1

      FYI: The acquisition is already complete.

  3. Unfortunately not particularly useful. by Anonymous Coward · · Score: 1

    Because almost every state uses British Common Law unless you know how the courts have ruled on a particular law. You don't know whether or not the courts have invalidated the law in whole, in part, or let it stand as is.

    Also, the courts consider the legislative notes from the committee that drafted the law as to what the intent of that particular code section is.

    More useful are the annotated codebooks that have not only the law but also how the courts have ruled on the law and how settled the validity of that law is.

    Many states have granted copyright of the court decisions you need in order to tell what the law is to Lexis and other companies. It feels like it should be unconstitutional for a private entity to have copyright of information you need in order to tell if an action is legal or not.

    1. Re:Unfortunately not particularly useful. by mermeid007 · · Score: 1

      Ah, the laws of tomorrow today!

    2. Re:Unfortunately not particularly useful. by Anonymous Coward · · Score: 0

      You don't know whether or not the courts have invalidated the law in whole, in part, or let it stand as is.

      That sounds like chaos. Anyway, the contentions issues such as administrative decisions, contract negotiations and tendering processes and such are obviously left out of all openly accessible systems unless the laws related to acquisition, publicity or good governance come into play. Stakeholders might need another, more private system to comment and participate on processes relevant to them. Who knows, maybe one day Facebook creates the Facebook for Governments product.

    3. Re:Unfortunately not particularly useful. by Actually,+I+do+RTFA · · Score: 2

      It feels like it should be unconstitutional

      An open records group (Public.Resources.Org) bought a copy of the annotated code of Georgia and published it online (think SciHub, but for law.) They got sued by the group that claimed to own the copyright. They took it to court, and, last month, won their court case The Supreme Court may overrule the Appeals Court, but it's now at that level (and doesn't seem likely).

      From my understanding, the case hinges on the fact that the judges and lawmakers are actually doing work for hire on behalf of the people, who would be the ones to own the copyright. Quotes in the articles are more elegantly phrased.

      --
      Your ad here. Ask me how!
  4. Close, but drafts would be even better. by hey! · · Score: 5, Interesting

    Every time somebody inserts something into a law, it should be committed with a digital certificate so we know exactly who is giving out the candy to whom.

    --
    Post may contain irony: discontinue use if experiencing mood swings, nausea or elevated blood pressure.
    1. Re:Close, but drafts would be even better. by Anonymous Coward · · Score: 0

      Oh, the Irony! But yes, you are absolutely correct. I am in total agreement with you.

    2. Re:Close, but drafts would be even better. by Anonymous Coward · · Score: 0

      Every time somebody inserts something into a law, it should be committed with a digital certificate so we know exactly who is giving out the candy to whom.

      I'm far from a programmer, but is this possible? I'd LOVE to see something like that become law, so you knew who did what, when, and where.

    3. Re:Close, but drafts would be even better. by hey! · · Score: 2

      It's no different from the way most non-trivial software projects are managed. A source control system automatically keeps track of every change made and who made them; you can get a complete audit trail of changes and recreate any old versions at will. In practice the process is very simple, all the complicated clerical tracking is done by the software.

      Personally I think many other kinds of work would benefit from using source control software. I have writer friends who complain about keeping track of old versions of manuscripts, and I keep telling them they should use a source control system. That way they could recall old versions that they decided might be better, keep notes on why they made certain changes, try out alternative endings, and keep all that mess organized, even merging different versions of a manuscript. The thing is, what a source control system does sounds so *magical* to them they just assume it's got to be incredibly complicated to use. It's not. All the complicated stuff is done under the covers for you.

      Now if you're setting up a system that's going to authenticate changes submitted by some person (as in the idea that we'll know who slipped something into a bill as a favor), that takes a bit more administrative expertise than running a local git repository. But it's not rocket science by any means.

      --
      Post may contain irony: discontinue use if experiencing mood swings, nausea or elevated blood pressure.
    4. Re: Close, but drafts would be even better. by Anonymous Coward · · Score: 0

      Git already supports that.
      You can use pgp to sign commits and tags.

    5. Re:Close, but drafts would be even better. by Anne+Thwacks · · Score: 1
      I have writer friends who complain about keeping track of old versions of manuscripts, and I keep telling them they should use a source control system.

      LibreOffice, MS Word, and most other credible writing tools have a "track changes" option which does this.

      It is also possible to tell LibreOffice to store documents in a form compatible with version control but hellishly difficult to find out about the feature (also applies to most LibreOffice features).

      Relevant to previous statement:
      The Internet desperately needs a way to hide old tech support info when out of date, unless a "reveal" button is pressed. There is a wealth of info on how to fix ancient versions of software, making it impossible to fund the latest fix. (Yes, I know: if Google search actually searched for the search terms you entered, it might be easier.)

      --
      Sent from my ASR33 using ASCII
    6. Re:Close, but drafts would be even better. by Kokuyo · · Score: 2

      I'll out myself here but I have a really hard time getting the hang of git...

      So yeah, it's nice that it's easy for you but their apprehension is not completely unfounded.

    7. Re: Close, but drafts would be even better. by Anonymous Coward · · Score: 0

      I assume the GP knows that and the point is that setting up Git and PGP is more complicated than setting up just Git. Especially if the PGP users are strongly incentivized to not keep their keys secure (so they can disown changes).

    8. Re:Close, but drafts would be even better. by rickb928 · · Score: 1

      "inserts something into a law, "

      That's legislation, even if it's merely DC.

      Which should, SHOULD be proposed to, and ratified by, the city council (or whatever). The public isn't inserting into law. alt least not legally.

      I suppose the council can authorize the changes to the repo. But it's not random insertions...

      --
      deleting the extra space after periods so i can stay relevant, yeah.
    9. Re:Close, but drafts would be even better. by hey! · · Score: 1

      It's not the same as "track changes", which has basically a linear concept of change.

      --
      Post may contain irony: discontinue use if experiencing mood swings, nausea or elevated blood pressure.
    10. Re:Close, but drafts would be even better. by hey! · · Score: 1

      This really applies more to Congress, where favors get anonymously slipped into bills at the last minute. But even in city laws, the bills are drafted by the city council and, for larger cities, edited by staff.

      --
      Post may contain irony: discontinue use if experiencing mood swings, nausea or elevated blood pressure.
    11. Re:Close, but drafts would be even better. by hey! · · Score: 1

      I recommended bzr (now breezy) based on its beginner-friendly interface. But if you are working alone, the subset of git you need to master is pretty small.

      --
      Post may contain irony: discontinue use if experiencing mood swings, nausea or elevated blood pressure.
    12. Re:Close, but drafts would be even better. by Anonymous Coward · · Score: 0

      Yeah, the parent is right. Source control is incredibly useful for just about everyone.

      It is wayyyyy more than the dumb track changes.

    13. Re:Close, but drafts would be even better. by at_slashdot · · Score: 1

      So the people giving the candy... and they pay more attention than the general public...

      --
      "It is our choices, Harry, that show what we truly are, far more than our abilities." -- Prof. Dumbledore
  5. user editable stories. by Anonymous Coward · · Score: 0

    and taht several other jurisdictions

    so if DC has editable laws, when can we expect to correct slashdot errors?

    1. Re:user editable stories. by Hognoxious · · Score: 1

      When slashdot fixes the quotes problem, or at least gets editors who proofread.

      Donawithahatontrademarkt hold your breath.

      --
      Confucius say, "Find worm in apple - bad. Find half a worm - worse."
    2. Re:user editable stories. by Anonymous Coward · · Score: 0

      That's all secondary minor shit, what we need is a good 100% purge of nazi faggots.

  6. What a feat! by Anonymous Coward · · Score: 0

    Too bad people can't push changes making this a completely worthless idea. They do get to use a neat buzz word to show Washington DC is "hip" and "with it" even if they don't understand why they can't use personal email for work.

    1. Re: What a feat! by Anonymous Coward · · Score: 0

      Hmm. Yeah let's let random slashdot trolls push changes. THAT would make it worthless. Did you not understand that git and xml are only tools to edit and publish documents, not meant to replace the process of deciding what should be in those documents?

    2. Re: What a feat! by Anonymous Coward · · Score: 0

      They don't need Github for that. It's clear they have no idea what they're doing.

  7. I wish this submission was on github.com by Anonymous Coward · · Score: 1

    Here's my pull request for typos, misspellings, and â(TM) fixes.

  8. Microsoft lobbied for this... by Anonymous Coward · · Score: 0

    You know it.

  9. One can only hope by Anonymous Coward · · Score: 0

    Gihub has good backups!

  10. I've never used github. Is it a decent VCS? by Snotnose · · Score: 4, Insightful

    VCS = Version Control System. In other words, can it track a document as it s revised, and KEEP TRACK OF WHO REVISED IT. I've wanted this in government for a good 30 years, about the time VCS's showed up. I'm so sick of hearing on the news "the added amendment..." while having no way to find out who added the amendment.

  11. Not the law, just their formatting tags and footno by raymorris · · Score: 4, Informative

    Neither statutes nor court opinions are copyright Lexis Nexus or Westlaw.

    What these companies have copyright on are:

    Their formatting tags they add (copy-pasted text from them as plain text, unformatted, to avoid any problems).

    The text of their notes about relevant cases, which they have selected and summarized.

    So if Westlaw says this:
    Subsection C was limited based on fair use considerations in Jones vs Smith (2012) regarding digital libraries.

    You can NOT directly copy-paste that. You CAN write this:
    See Jones vs Smith (2012)

    Or this:
    For fair use exceptions, see Jones v Smith

    Or even put the entire text of the Jones v Smith ruling.
    You just can't copy-pasted the exact words that LN or Westlaw wrote.

  12. Alternate headline: Microsoft IS the law by themusicgod1 · · Score: 0

    You MUST use microsoft to participate in US Democracy ^[TM].

    --
    GENERATION 26: The first time you see this, copy it into your sig on any forum and add 1 to the generation.
  13. Ps a citation for you by raymorris · · Score: 1

    "the U.S. Copyright Office will not register a government edict that has been issued by any state, local, or territorial government, including legislative enactments, judicial decision, administrative rulings, public ordinances, or similar types of official legal materials." U.S. Copyright Office Practices  313.6(C)(2)

    Not it explicitly says judicial decisions can not be registered for copyright. Yes I'm aware Lexis Nexus doesn't like that.

  14. Re:I've never used github. Is it a decent VCS? by Anonymous Coward · · Score: 0

    Who directed the chump to change the law is more important. These days national security laws are being made vague and open ended- deliberately so as not to upset the public too much . Same with public private partnerships that need revision the day after signing for unexpected unmet changes or demand.

  15. Re:I've never used github. Is it a decent VCS? by Yosho · · Score: 2

    GitHub is basically a web-based frontend for git, which is the de facto king of VCSes. Almost every open source project actively under development today uses it, and it's also commonly used by many closed-source software developers (including, for example, Microsoft, who also owns GitHub).

    --
    Karma: Terrifying (mostly affected by atrocities you've committed)
  16. XML? by Anonymous Coward · · Score: 0

    Since then the US parliament has been busy examining a law proposition about the "billion laugh attack". They're not amused but the procedure is strict and has to be followed for the sake of democracy. They're currently processing 43 laughs per day but hope to double that by convening extraordinary sessions lasting up until 5 AM six days of the week.

  17. Re:I've never used github. Is it a decent VCS? by Anonymous Coward · · Score: 0

    In this case.... sort of?

    Really, the VCS in question is "Git", and "GitHub" is just one hosting provider of Git. Git is an excellent system for this:
    * Easy to copy (I can 'clone' the entire repoistory from GitHub and have a full copy of all history on my copy of it
    * Easy to move (it's as simple as clone (download) the repository and then pushing it to a new host, all very well documented commands.)
    * SHA-1 cryptographic authentication. Every version in the repository is identifed by the "SHA1" checksum, which includes:
        * All content in that version (both altered and unaltered files)
        * The identity of the creator of that version (email address, anyway)
        * The SHA-1 of the previous versions
        * and probably other things.
    * Git supports signing the SHA1 with PGP style approach.

    This means that the SHA1 is 'untamperable'.

    However, honestly, the article is more about GitHub's workflow for requesting changes.

  18. Law on uncontrolled server? by uldics · · Score: 1

    Is it just me who sees huge risks in putting law on someone elses computer? The git repo admins rights there are laughable compared to root - that somebody else making your nice frontend stick nicely together with backend, able to do whatever with laws therein. Cloud still needs security, some of which it can not provide, at least in this form, without end to end encription and then some. I do not suspect Microsoft going in and changing a law, but why give the chance when temptation would be there already. Why arent they deploying the repositories on own servers?

    1. Re:Law on uncontrolled server? by Anonymous Coward · · Score: 0

      Changes to documents on Github don't magically make them reality.

    2. Re:Law on uncontrolled server? by Anonymous Coward · · Score: 0

      If you're particularly concerned, grab a copy of the git commit ID of the head of master. Then, if that commit magically disappears, you know something fishy has happened, and if not, you know nothing fishy has happened.

      More generally, there's no real risk here, since changing the laws on the server would be only an embarrassment; humans would quickly notice and take action.

    3. Re: Law on uncontrolled server? by Anonymous Coward · · Score: 0

      Blockchain hype

    4. Re:Law on uncontrolled server? by djinn6 · · Score: 2

      Git (and really any DVCS) already handles this problem. Since a complete copy is always stored locally, any attempt to rewrite Git history will cause people to see unexpected merges or errors when updating their local repo. Not to mention if any of them issue a "git diff master origin/master", they would immediately see the changes. For the very paranoid, they can also add another remote repo that belongs to someone they trust, and compare it with the one on GitHub.

      Creating a Git repo is probably one of the most robust way to ensure it cannot be tampered with. Even the alternative of storing it on paper is not as good because a surreptitiously modified copy could not be easily compared to other copies. So the changes could be undiscovered a long period of time. With Git, there would be thousands of lawyers, judges and special interest groups, each with their own copy of the law to which any changes would be easily noticeable. The fact that the copy GitHub hosts is canonical does not compromise its integrity at all.

  19. Re:I've never used github. Is it a decent VCS? by Anonymous Coward · · Score: 0

    Also, GitLab is another one. A difference is you can host your own.

    Many projects may dump their code on github for public visibility / as a convenience for people of the general public who know to navigate it.
    https://help.github.com/articles/about-github-mirrors/

  20. Supporting evidence why laws are so screwed... by Anonymous Coward · · Score: 0

    Hoping that your edits to the laws didn't have as many spelling mistakes, grammatical errors, etc that this article does.

  21. Re:I've never used github. Is it a decent VCS? by 93+Escort+Wagon · · Score: 4, Funny

    Yeah, it was unfortunate, but understandable, that the Founding Fathers initially went with CVS - despite John Quincy Adams’ strong advocacy for SVN.

    Regardless, it’s good to see that the city of DC, at least, has upgraded to git.

    --
    #DeleteChrome
  22. I really like this by oldgraybeard · · Score: 2

    All regulations and laws at all levels of government should be public domain. ATM they are not!

    Just my 2 cents ;)

  23. Can of worms waiting to be opened. by Anonymous Coward · · Score: 0

    This just sounds like all sorts of trouble. Even tiny "grammatical errors" shouldn't just be willy nilly edited in law without going though the proper channels. Lawyers and judges have field days twisting around the meaning of the slightest little thing in how a law is written that the average joe would probably completely overlook.

    https://www.abc.net.au/news/2017-03-21/the-case-of-the-$13-million-comma/8372956

    Something like github or a wiki however could be used to allow others to point out tiny "grammatical errors" that the proper channels could then review, approve and put into an actual read only repository.

  24. Re:I've never used github. Is it a decent VCS? by grep+-v+'.*'+* · · Score: 2

    itâ(TM)s good to see that the city of DC, at least, has upgraded to git.

    I wish DC would tell *all* of the legislators there to GIT and stay git.

    --
    If the universe is someone's simulation -- does that mean the stars are just stuck pixels?
  25. My first two thoughts were: by Anonymous Coward · · Score: 0

    'Handing Microsoft the keys to file cabinet containing their next anti-trust trial.' followed by 'I bet the Chinese/Russians already have a backdoor.' to 'The AUTHORITATIVE SOURCE?!?!' and finally like someone else here: 'Where are the links to draft changes so we can see each asshole representative or senator who tries to sneak something nasty on a new bill, and comments from senators dissenting or affirming the change.'

    America is not improving my opinion of it. People with no understanding of technology are either incompetently or maliciously choosing the worst way to implement it in their project of choice.

    On the bright side: At least there will finally be free public distribution of laws, at least under Microsoft starts rent seeking on git pull requests :)

  26. Rather use a gitlab instance by Anonymous Coward · · Score: 0

    I know they used Github for network effect but I think a public Gitlab instance would fit better. The goverment would be seperate and promote free software.
    A mirror to Github would still be possible.

  27. Changes to law require legislative action by Anonymous Coward · · Score: 0

    Fixing a typo has legal ramifications.

  28. Re:I've never used github. Is it a decent VCS? by Anonymous Coward · · Score: 0

    git is really good, but it's not the de facto king of VCSes.
    The biggest problem w/git is its lack of coherent and transparent versioning.
    Yeah, I know about tags, etc. but there's no way to automatically attach
    a version to a file (think $Id:). It's my only complaint (I really don't want to
    hear that I don't need it from some idiot out there.

    CAP === 'centrist'

  29. Blockchain based lawbooks? by ctilsie242 · · Score: 1

    Blockchain based lawkeeping. Can't argue with that, because it would at least show what laws got passed/modified/repealed. Hell, Git is one small step away from being a blockchain, it just needs some crypto signatures for every commit, modification and push to the repository.

    I can't argue with this.

    1. Re: Blockchain based lawbooks? by locketine · · Score: 1

      Git supports PGP signatures on commits; so yeah, it's like blockchain but with less dispute resolution built in.

      I had a job applicant farm out his code sample to an Indian contractor. I caught him because they used GitHub and the only commits that were his were merges from the contractor. Imagine having such a system show how many of our laws are written by lobbyists.

      --
      Think globally but act within local variable scope.
  30. Re:I've never used github. Is it a decent VCS? by Anonymous Coward · · Score: 0

    Also, GitLab is another one. A difference is you can host your own.

    Many projects may dump their code on github for public visibility / as a convenience for people of the general public who know to navigate it.
    https://help.github.com/articles/about-github-mirrors/

    Another difference is that GitHub is owned my Microsoft. GitLab is not. GitLab also has public hosting like GitHub. at gitlab.com

  31. Microsoft and the Law by Anonymous Coward · · Score: 0

    Is that why Microsoft bought GitHub, to make it more "Legal"?

  32. Re:I've never used github. Is it a decent VCS? by fuzzyfuzzyfungus · · Score: 1

    The tricky bit will be dealing with the 'garbage in/garbage out' problem. As a technical matter any vaguely competent VCS, ideally with cryptographic signatures(whether integral to the design or bolted on; conveniently CACs and PIVs already support signing, so a lot of fed-level IDs do signing in addition to authentication) can keep track of who changed what when; but there is no technical fix for people dumping big ugly blobs that probably represent dozens or hundreds of internal changes into the publicly visible system as a single commit.

    Even that beats the 'somebody changed something at some time, we think, because it's definitely changed now and we just passed it by voice vote' system we currently have; but I'd expect to see a lot of cases where a chunk of law, carefully prewritten, gets committed by someone's deniable junior staffer with all the care for mainline compatibility exhibited by a shoddy router vendor engaging in minimum-necessary GPL 'compliance' by vomiting forth their hideous BSP lump.

    Can't beat the system once you do commit; and you can enforce at least one interaction with the system by mandating that the authoritative text of the law is the one that comes out of the VCS; but if someone is feeling uncooperative they can deny the system a lot of information by sticking to 11th hour giant blob commits.

  33. Nazi homosexual recruiter RAY MORRIS =propagandist by Anonymous Coward · · Score: 0
  34. You insult someone by calling them a homosexual? by raymorris · · Score: 1

    In your mind, the worst insult you can come up with is "homosexual recruiter"?

    Your bigoted ideas went of fashion in the 1970s, bro.

  35. Why XML and not markdown? by locketine · · Score: 1

    These laws need some basic formatting and links. Markdown provides that and is much easier to use, read, understand and modify. So why are they using XML?

    My guess is that they exported the laws from word as XML because that's built-in, not caring about what to do next.

    --
    Think globally but act within local variable scope.