{"action":"created","issue":{"url":"https://api.github.com/repos/greenelab/manubot/issues/1","repository_url":"https://api.github.com/repos/greenelab/manubot","labels_url":"https://api.github.com/repos/greenelab/manubot/issues/1/labels{/name}","comments_url":"https://api.github.com/repos/greenelab/manubot/issues/1/comments","events_url":"https://api.github.com/repos/greenelab/manubot/issues/1/events","html_url":"https://github.com/greenelab/manubot/issues/1","id":240036199,"number":1,"title":"Automatically generating JSON CSL (citation metadata) for legal cases","user":{"login":"dhimmel","id":1117703,"avatar_url":"https://avatars2.githubusercontent.com/u/1117703?v=3","gravatar_id":"","url":"https://api.github.com/users/dhimmel","html_url":"https://github.com/dhimmel","followers_url":"https://api.github.com/users/dhimmel/followers","following_url":"https://api.github.com/users/dhimmel/following{/other_user}","gists_url":"https://api.github.com/users/dhimmel/gists{/gist_id}","starred_url":"https://api.github.com/users/dhimmel/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dhimmel/subscriptions","organizations_url":"https://api.github.com/users/dhimmel/orgs","repos_url":"https://api.github.com/users/dhimmel/repos","events_url":"https://api.github.com/users/dhimmel/events{/privacy}","received_events_url":"https://api.github.com/users/dhimmel/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":9,"created_at":"2017-07-02T21:37:18Z","updated_at":"2017-07-07T22:56:50Z","closed_at":null,"body":"Currently, we support citation of DOIs, arXiv IDs, PubMed IDs, and URLs. For the [Sci-Hub paper](https://github.com/greenelab/scihub) it would be nice to cite legal documents. Currently, if we wanted to cite a legal document, we'd do it by URL. Hopefully Greycite could dig up correct metadata. If not we'd have to manually create the JSON CSL.\r\n\r\nThe first question is do cases and their documents have standard identifiers? Let's focus on U.S. cases. The case I'm interested in is `1:15-cv-04282-RWS` (Elsevier Inc. et al v. Sci-Hub et al). PlainSite has a nice [landing page](https://www.plainsite.org/dockets/2lt9206gt/new-york-southern-district-court/elsevier-inc-et-al-v-scihub-et-al/) for this case with PDFs for some documents available. It appears to me that there is a government database called PACER. You must pay to get documents out of PACER. However, since the documents are public domain, anyone can distribute them freely. Now, I don't think we can use Greycite with PACER URLs, since PACER is login-walled. Is there a public database with pages for all US court documents?\r\n\r\n@fbennett I saw you [wrote about](https://blog.law.cornell.edu/voxpop/2011/10/02/csl-metadata-and-legal-information-that-just-works/) CSL citation of legal cases in 2011. Any insights? FYI, see the [deep review](https://github.com/greenelab/deep-review) to get an idea of what this codebase intends to enable. In short, citing by standard identifiers that trigger automated reference/bibliography creation.\r\n\r\nSome APIs:\r\n+ eclout has an API for PACER, but it's not free / public: https://www.enclout.com/api/v1/pacer\r\n+ PlainSite also has an API, but only for Stanford folks: https://www.plainsite.org/api/. PlainSite also suggests a standard citation method like `docket://gov.uscourts.nysd.1-15-cv-04282`\r\n+ https://www.courtlistener.com/api/\r\n\r\n\r\nUpdate. See the court listener page for the [Sci-Hub case](https://www.courtlistener.com/docket/4355308/elsevier-inc-v-sci-hub/) and [OASIS Legal Citation Markup (LegalCiteM) TC](https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=legalcitem).\r\n\r\nCourt Listener has pages for individual documents / entries. For example, https://www.courtlistener.com/docket/4355308/1/elsevier-inc-v-sci-hub/. For now I will use these URLs as the unique identifier for cases."},"comment":{"url":"https://api.github.com/repos/greenelab/manubot/issues/comments/313811681","html_url":"https://github.com/greenelab/manubot/issues/1#issuecomment-313811681","issue_url":"https://api.github.com/repos/greenelab/manubot/issues/1","id":313811681,"user":{"login":"anseljh","id":2075772,"avatar_url":"https://avatars2.githubusercontent.com/u/2075772?v=3","gravatar_id":"","url":"https://api.github.com/users/anseljh","html_url":"https://github.com/anseljh","followers_url":"https://api.github.com/users/anseljh/followers","following_url":"https://api.github.com/users/anseljh/following{/other_user}","gists_url":"https://api.github.com/users/anseljh/gists{/gist_id}","starred_url":"https://api.github.com/users/anseljh/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/anseljh/subscriptions","organizations_url":"https://api.github.com/users/anseljh/orgs","repos_url":"https://api.github.com/users/anseljh/repos","events_url":"https://api.github.com/users/anseljh/events{/privacy}","received_events_url":"https://api.github.com/users/anseljh/received_events","type":"User","site_admin":false},"created_at":"2017-07-07T22:56:49Z","updated_at":"2017-07-07T22:56:49Z","body":"Lawyer here! Let me know if I can help in any way, @dhimmel. You might also want to check out https://github.com/adelevie/walverine, which is in a way the inverse of what I think you're doing (it extracts data from legal citation strings).\r\n\r\nSome things that might be helpful for data modeling:\r\n\r\n* A case is in a court.\r\n* A case has a case number that uniquely identifies it _within that court_.\r\n* A case _may_ have one or more opinions.\r\n* A case has many documents, each of which has a docket number (or entry).\r\n\r\nSo to uniquely identify any given document in a case, you need to know its court, case number, and docket number.\r\n\r\nThe most common thing to cite is an opinion. Some example citations to opinions:\r\n\r\n* `Brown v. Board of Education of Topeka, 347 U.S. 483 (1954)` -- for a Supreme Court opinion\r\n* `Hollingsworth v. Perry, 704 F.Supp.2d 921 (N.D. Cal., 2010)` -- for a published federal District Court opinion\r\n* `Gentry v. eBay, Inc., 99 Cal.App.4th 816 (2002)` -- published state appellate court opinion\r\n\r\nIf you wanted to cite a document that wasn't an opinion, you'd do it like this:\r\n\r\n`Brief of Meredith Patterson, et al. as Amici Curiae Supporting Appellant at 4–11, U.S. v. Auernheimer, 748 F.3d 525 (3rd Cir. 2014) (filed July, 8, 2013) (No. 13-1816) (brief of computer security researchers describing the web’s open architecture)`"}}
{"actor":{"display_login":"anseljh"}}