diff --git a/.zenodo.json b/.zenodo.json index 108a7f6..0b6e8eb 100644 --- a/.zenodo.json +++ b/.zenodo.json @@ -3,7 +3,7 @@ "upload_type": "software", "access_right": "open", "license": "PolyForm-Noncommercial-1.0.0", - "description": "Paragraph-level research environment for UN human rights law. UNHRDB combines Treaty Body General Comments and Recommendations, individual-communication jurisprudence, and thematic Special Procedures reports in a source-first interface with faceted search, citation export, document workspaces, and extractive retrieval. The software and curated datasets have separate licences; see LICENSE, LICENSE-DATA, and NOTICE in the repository. The v2.1.0 release (3 September 2026) covers 6,152 documents and 326,448 paragraphs: 188 General Comments and Recommendations, 4,333 individual-communication decisions from 8 treaty bodies, and 1,631 thematic Special Procedures reports from all 46 mandates. The repository holds the published site and its front-end code; the data-processing pipeline is kept in a separate, private repository.", + "description": "Paragraph-level research environment for UN human rights law. UNHRDB combines Treaty Body General Comments and Recommendations, individual-communication jurisprudence, and thematic Special Procedures reports in a source-first interface with faceted search, citation export, document workspaces, and extractive retrieval. The software and curated datasets have separate licences; see LICENSE, LICENSE-DATA, and NOTICE in the repository. The v2.2.0 release (15 October 2026) covers 6,152 documents and 326,448 paragraphs: 188 General Comments and Recommendations, 4,333 individual-communication decisions from 8 treaty bodies, and 1,631 thematic Special Procedures reports from all 46 mandates. The repository holds the published site and its front-end code; the data-processing pipeline is kept in a separate, private repository.", "creators": [ { "name": "Szoszkiewicz, Łukasz", diff --git a/CITATION.cff b/CITATION.cff index 71e9370..6cfcacd 100644 --- a/CITATION.cff +++ b/CITATION.cff @@ -36,5 +36,5 @@ license-url: "https://polyformproject.org/licenses/noncommercial/1.0.0/" repository-code: "https://github.com/lszoszk/generalcomments" url: "https://lszoszk.github.io/generalcomments/" doi: "10.5281/zenodo.10495719" -version: "2.1.0" -date-released: "2026-09-03" +version: "2.2.0" +date-released: "2026-10-15" diff --git a/README.md b/README.md index 7ffc7e4..484df7b 100644 --- a/README.md +++ b/README.md @@ -103,7 +103,7 @@ as part of that dataset package. For the evolving software, use the concept DOI: > Szoszkiewicz, Ł., & Kowalska, Z. (2026). *UNHRDB — UN Human Rights -> Database* (Version 2.1.0) [Computer software]. Zenodo. +> Database* (Version 2.2.0) [Computer software]. Zenodo. > https://doi.org/10.5281/zenodo.10495719 GitHub also exposes machine-readable citation metadata from diff --git a/codemeta.json b/codemeta.json index afaa36c..dfdddca 100644 --- a/codemeta.json +++ b/codemeta.json @@ -5,8 +5,8 @@ "description": "Paragraph-level search, reading, and citation environment for UN Treaty Body General Comments, jurisprudence, and thematic Special Procedures reports.", "codeRepository": "https://github.com/lszoszk/generalcomments", "url": "https://lszoszk.github.io/generalcomments/", - "version": "2.1.0", - "datePublished": "2026-09-03", + "version": "2.2.0", + "datePublished": "2026-10-15", "license": "https://polyformproject.org/licenses/noncommercial/1.0.0/", "applicationCategory": "Legal research software", "programmingLanguage": ["JavaScript", "Python", "HTML", "CSS"], diff --git a/docs/index.html b/docs/index.html index fe4ef46..f6cd7df 100644 --- a/docs/index.html +++ b/docs/index.html @@ -118,8 +118,8 @@ "https://github.com/lszoszk/generalcomments", "https://huggingface.co/datasets/lszoszk/treaty-bodies-general-comments" ], - "version": "2.1.0", - "dateModified": "2026-09-26", + "version": "2.2.0", + "dateModified": "2026-10-15", "temporalCoverage": "1960/2026", "inLanguage": "en", "isAccessibleForFree": true, @@ -128,7 +128,7 @@ { "@type": "Person", "name": "Zuzanna Kowalska" } ], "license": "https://creativecommons.org/licenses/by-nc-sa/4.0/", - "citation": "Szoszkiewicz, Ł., & Kowalska, Z. (2026). UNHRDB — UN Human Rights Database (Version 2.1.0). Zenodo. https://doi.org/10.5281/zenodo.10495719", + "citation": "Szoszkiewicz, Ł., & Kowalska, Z. (2026). UNHRDB — UN Human Rights Database (Version 2.2.0). Zenodo. https://doi.org/10.5281/zenodo.10495719", "keywords": ["human rights", "UN treaty bodies", "general comments", "general recommendations", "jurisprudence", "individual communications", "special procedures", "international law", "legal information retrieval"], "distribution": [ { diff --git a/docs/llms.txt b/docs/llms.txt index b2e8074..91f0706 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -18,15 +18,39 @@ General Comments are authoritative interpretations of a treaty by its monitoring ## How to link and cite - A paragraph: https://lszoszk.github.io/generalcomments/?p=, e.g. https://lszoszk.github.io/generalcomments/?p=ccpr-c-gc-36-0012 (Human Rights Committee, general comment No. 36, para. 12). -- A search: https://lszoszk.github.io/generalcomments/?q= +- A search: https://lszoszk.github.io/generalcomments/?q= (operators and filters below). - Every document as a plain HTML page without JavaScript, full text with paragraph anchors: https://lszoszk.github.io/generalcomments/d//#p, e.g. https://lszoszk.github.io/generalcomments/d/ccpr-c-gc-36/#p12. Index of all documents: https://lszoszk.github.io/generalcomments/d/ - Cite the underlying UN document by its symbol and paragraph (e.g. CCPR/C/GC/36, para. 12); the official text is at https://docs.un.org/en/. -- Cite the database itself as: Szoszkiewicz, Ł., & Kowalska, Z. (2026). UNHRDB — UN Human Rights Database (Version 2.1.0). Zenodo. https://doi.org/10.5281/zenodo.10495719 +- Cite the database itself as: Szoszkiewicz, Ł., & Kowalska, Z. (2026). UNHRDB — UN Human Rights Database (Version 2.2.0). Zenodo. https://doi.org/10.5281/zenodo.10495719 + +## Search syntax and filter URLs + +Query operators (parameter q): +- "exact phrase" — the words verbatim and in order; no stemming. +- A B — whitespace is AND: both terms must appear. +- A AND B, A OR B — AND binds tighter than OR; group with ( … ). +- A NOT B, or A -B — exclude B; an exclusion needs a positive term beside it. +- prefix* — trailing asterisk matches any continuation (discriminat* finds discrimination, discriminatory). +- Bare words match the word form as typed; there is no proximity (NEAR) operator. + +Filters, each a URL parameter; several values are joined with | : +- scope — gc (General Comments, the default), jur (treaty-body decisions), sp (Special Procedures reports), all (the three together), rec (recommendations to States). +- tb — treaty body or mandate, as shown in the filter panel: CCPR, CESCR, CRC, CEDAW, CERD, CAT, CRPD, CMW, CED; Special Procedures as "SR Privacy", "SR Torture", "WG Arbitrary Detention" and so on. +- y1, y2 — first and last year. +- g — groups concerned, e.g. Children, Women/girls, Persons with disabilities, Indigenous peoples, Migrants. +- jur only: cy (State party, e.g. Algeria), oc (outcome: violation_found, merits_no_violation, inadmissible, discontinued). +- fn=1 also searches footnotes (off by default). + +Examples: +- https://lszoszk.github.io/generalcomments/?q=%22best+interests%22+-adoption&tb=CRC|CESCR&g=Children +- https://lszoszk.github.io/generalcomments/?q=%22enforced+disappearance%22&scope=jur&tb=CCPR&cy=Algeria&oc=violation_found&y1=2015 +- https://lszoszk.github.io/generalcomments/?q=biometric*+AND+(surveillance+OR+facial)&scope=sp&y1=2018 ## Using it from an AI assistant - Connector (MCP, Streamable HTTP, no key): https://150.254.115.204/unhrdb-mcp-rpc/mcp — tools search_paragraphs, lookup_by_citation, search_recommendations, lookup_recommendation, list_uhri_facets. - Claude plugin with the connector and three skills (un-human-rights-research, un-citation-check, treaty-body-case-law): https://github.com/lszoszk/mcp-unhrdb#skills-for-claude. Skills for the recommendations to States (uhri-plus, uhri-plus-country-brief, uhri-plus-legal-grounding, uhri-plus-dashboard-link): https://lszoszk.github.io/UnitedNations_recommendations/skills/README.md. In Claude Code: `/plugin marketplace add lszoszk/mcp-unhrdb`, then `/plugin install unhrdb@mcp-unhrdb`. +- Step-by-step guide to connecting Claude, ChatGPT and other assistants: https://lszoszk.github.io/UnitedNations_recommendations/ai.html - Quote the returned text verbatim and cite the UN symbol and paragraph. Searches require all bare words (use OR, "phrases" and prefix*); check that a looked-up paragraph carries the label you asked for. ## Data and tools