Skip to content

Latest commit

 

History

History
279 lines (216 loc) · 14.1 KB

CLAUDE.md

File metadata and controls

279 lines (216 loc) · 14.1 KB

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

LOCAL DIRECTORY NOTE: This directory (unjournal-gitbook-knowledge-comms) is the canonical working copy of the unjournal/unjournal_gitbook GitHub repo. There is a stale duplicate at ~/githubs/_STALE_unjournal_gitbook/ — do NOT use that one. It can be safely deleted once you confirm no scripts depend on it.

Repository Overview

This is The Unjournal's public knowledge base and communications repository. The Unjournal provides open, rigorous evaluation of quantitative research informing global priorities, especially in economics, policy, and social science.

The repository contains:

  • GitBook content: Markdown files organized by topic (policies, benefits, FAQ, grants, etc.)
  • Landing pages (landing-pages/): Static HTML pages hosted on info.unjournal.org
  • Interactive docs (docs/): Mermaid diagram gallery, Reveal.js presentations, and interactive process diagrams

Internal operations, deployment scripts, and automation tools are in the private ops-internal repo.

GitBook Content Structure

  • SUMMARY.md - Table of contents defining navigation structure
  • README.md - Landing page content
  • Content organized in directories: benefits-and-features/, policies-projects-evaluation-workflow/, faq-interaction/, readme-1/ (about/team info), etc.

GitBook-Specific Markdown

GitBook uses custom syntax including:

  • {% hint style="info" %}...{% endhint %} - Callout boxes
  • {% embed url="..." %} - Embedded links
  • {% code overflow="wrap" %} - Code block formatting
  • YAML frontmatter for page layout configuration

Landing Pages (info.unjournal.org)

Pages

  • landing-pages/index.html — General Unjournal overview
  • landing-pages/about.html — "In a Nutshell" overview of The Unjournal
  • landing-pages/benefits.html — Benefits & features of journal-independent evaluation
  • landing-pages/for-authors.html — FAQ and information for researchers/authors
  • landing-pages/for-evaluators.html — Information and recruitment for evaluators
  • landing-pages/team.html — Management team, advisory board, and field specialists
  • landing-pages/news.html — News feed page
  • landing-pages/pivotal-questions.html — High-value-of-information research initiative
  • landing-pages/forecasting-tournament.html — Animal welfare forecasting tournament (with Metaculus)
  • landing-pages/forecasting-tournament-thanks.html — Post-signup confirmation
  • landing-pages/follow.html — Social media, news, and engagement hub
  • landing-pages/donate.html — Donation/support page
  • landing-pages/evaluator-prizes-2024-25.html — Evaluator prize winners announcement
  • landing-pages/lottery.html — Transparent random draw for honorable mention prizes

Team Page Notes

  • Source of truth: Team structure is managed in Coda (coda_org_unjournal repo)
  • Photos: Sourced from Squarespace CDN (images.squarespace-cdn.com) via unjournal.org/team
  • Manual sync: When team changes, update both Coda (via update_team.py) and team.html
  • Team members without photos use initials placeholders (gradient background)

Design conventions

  • All pages use academic serif fonts: Libre Baskerville for headings, Georgia for body text (donate.html uses Almarai for body)
  • Unjournal logo (unjournal-logo.jpg) in every page header, linking to unjournal.org
  • Color scheme: --primary: #1a3a5c, --accent: #2e86c1, consistent across all pages

Interactive Docs (docs/)

Served via GitHub Pages at https://unjournal.github.io/unjournal_gitbook/.

  • docs/gallery.html — Mermaid diagram gallery with theme/font/shape/size controls and export buttons
  • docs/reveal-*.html — Reveal.js step-through presentations (evaluation process, theory of change)
  • docs/interactive.html — Interactive process diagram
  • docs/diagrams/ — SVG/image assets for diagrams

Style Guide

The Unjournal maintains a style guide for documentation consistency: https://docs.google.com/document/d/10aooH_YCVX__pXFqnY1l8Kn2_DPX9wdHdR9AfImSuDs/edit

Key URLs

  • Public GitBook: https://globalimpact.gitbook.io/the-unjournal-project-and-communication-space/
  • PubPub evaluations: https://unjournal.pubpub.org/
  • Shiny dashboard: https://unjournal.shinyapps.io/uj-dashboard/
  • Main website: https://unjournal.org
  • Ad Grant landing pages: https://info.unjournal.org
  • Wellbeing Workshop: https://uj-wellbeing-workshop.netlify.app
  • PBA Workshop: https://uj-pba-workshop.netlify.app
  • CM Workshop: https://uj-cm-workshop.netlify.app
  • All Workshops Landing: https://uj-pq-workshops.netlify.app

Pivotal Questions Workshops (pivotal-questions/)

Workshop scheduling and beliefs elicitation forms for the Pivotal Questions initiative.

Wellbeing Workshop (pivotal-questions/workshop-form/)

  • URL: https://uj-wellbeing-workshop.netlify.app
  • Netlify Site ID: 37a0205b-5cee-42c2-9388-fe0c17b5e5c6
  • Netlify Account: daaronr (nonprofit)
  • Deploy: npx netlify-cli deploy --prod --dir=. --site 37a0205b-5cee-42c2-9388-fe0c17b5e5c6
  • Forms dashboard: https://app.netlify.com/sites/uj-wellbeing-workshop/forms
  • Private tracking doc: /Users/yosemite/unjournal-private/workshop-tracking/wellbeing-workshop-feedback.md
  • Netlify API: Use NETLIFY_AUTH_TOKEN in repo .env to fetch form submissions
  • Form ID (workshop-availability): 699c9edf50f843000883f05e
  • Target date: March 16, 2026 (Mon-Thu 11am-5pm ET best overlap)

Pages

  • index.html — Scheduling form (availability grid, segment interest)
  • about.html — Workshop overview and goals
  • beliefs.html — Pivotal Questions beliefs elicitation form
  • thanks.html / beliefs-thanks.html — Post-submission confirmations

Forms (Netlify Forms)

  • workshop-availability — Scheduling submissions
  • beliefs-elicitation — Beliefs/forecasts submissions

Design

  • Academic aesthetic: Source Serif 4 + DM Sans fonts
  • Color palette: --bg: #f8f6f1, --sage: #5a7a5a, --brown: #8b5e3c
  • Shared styles in styles.css, interactivity in app.js and beliefs.js

Key Participants & Constraints (as of Feb 2026)

  • Confirmed presenters: Julian Jamison (PQ2), Dan Benjamin (paper), Miles Kimball (paper), Matt Lerner (practitioner), Peter Hickman (stakeholder)
  • Recording constraints: Matt Lerner and Peter Hickman require internal-only recording
  • Matt Lerner (FP): Only available Mon-Thu after 11am ET, after March 15
  • Alberto Prati: On paternity leave from Mar 14 - offered to join later Spring session
  • Caspar Kaiser: Availability pending clarification (misunderstood "March ~3hrs" as "March 3rd")

Cultivated Meat Workshop (pivotal-questions/cm-workshop/)

  • URL: https://uj-cm-workshop.netlify.app
  • Netlify Site ID: 7c6efdd4-f6db-4b13-8355-0bb5b64d0e6e
  • Netlify Account: daaronr (nonprofit)
  • Deploy: npx netlify-cli deploy --prod --dir=. --site 7c6efdd4-f6db-4b13-8355-0bb5b64d0e6e
  • Forms dashboard: https://app.netlify.com/sites/uj-cm-workshop/forms
  • Status: PRELIMINARY DRAFT (prominent caveats throughout)
  • Target date: April 2026

Pages

  • index.html — Workshop overview / About page (home page)
  • schedule.html — Scheduling form (April 2026 dates, 4 segments)
  • beliefs.html — CM_01, CM_02, CM_10/11 + technical subquestions (CM_12-20)
  • thanks.html / beliefs-thanks.html — Post-submission confirmations

Forms (Netlify Forms)

  • cm-workshop-availability — Scheduling submissions
  • cm-beliefs-elicitation — Beliefs/forecasts submissions

Content Sources

  • PQ formulations from /Users/yosemite/githubs/cm_pq_interface/cm_pq_downloads/
  • TEA rankings and paper list from same location
  • Metaculus questions: CM_01, CM_03, CM_10, CM_11

Plant-Based Substitution Workshop (pivotal-questions/pba-workshop/)

  • URL: https://uj-pba-workshop.netlify.app
  • Netlify Site ID: b065c5c3-a6c8-4261-8dac-13d17383ceaa
  • Netlify Account: daaronr (nonprofit)
  • Deploy: npx netlify-cli deploy --prod --dir=. --site b065c5c3-a6c8-4261-8dac-13d17383ceaa
  • Forms dashboard: https://app.netlify.com/sites/uj-pba-workshop/forms
  • Status: PRELIMINARY DRAFT (prominent caveats throughout)
  • Target date: May 2026

Pages

  • index.html — Workshop overview / About page (home page)
  • schedule.html — Scheduling form (May 2026 dates, 6 segments)
  • beliefs.html — PBA_01 (focal: chicken consumption), PBA_02-03, PBA_06-08 (subquestions)
  • thanks.html / beliefs-thanks.html — Post-submission confirmations

Forms (Netlify Forms)

  • pba-workshop-availability — Scheduling submissions
  • pba-beliefs-elicitation — Beliefs/forecasts submissions

Content Sources

  • PQ formulations from Coda tables and EA Forum
  • Question codes: PBA_01-08 (operationalized pivotal questions)
  • Metaculus questions: GFI vs THL comparison
  • Forecasting Tournament integration

Workshops Landing Page (pivotal-questions/workshops-landing/)

  • URL: https://uj-pq-workshops.netlify.app
  • Netlify Site ID: 9abc4eb7-bc5c-4bfd-83c2-2fbcf1b8cfe9
  • Netlify Account: daaronr (nonprofit)
  • Deploy: npx netlify-cli deploy --prod --dir=. --site 9abc4eb7-bc5c-4bfd-83c2-2fbcf1b8cfe9
  • Single page listing all workshop cards with status badges and links

Future Workshops

When creating additional PQ workshops:

  1. Create new directory under pivotal-questions/
  2. Create new Netlify site with topic-specific name
  3. Use same design patterns and form structure
  4. Add draft banners if preliminary

Domain & Hosting Infrastructure

Domain Registration

info.unjournal.org Hosting

  • Server: Linode VPS at 45.79.160.157
  • Web server: Nginx
  • Document root: /var/www/info.unjournal.org/
  • Deploy: SCP files to server, Nginx serves them automatically

Content Maintenance Notes

Statistics (update periodically)

  • As of January 2026: 100+ evaluations of 53 papers
  • Source of truth: Shiny dashboard and internal Coda

Archived content

Historical content (pilot phase 2022-2023, old job postings, etc.) is preserved in <details> collapsible sections rather than deleted, to maintain persistent links.

Internal vs public links

  • Never link to internal Coda pages in public GitBook content (except parenthetically for team reference)
  • Use relative paths for internal GitBook links, not full URLs

Prize programs

  • 2023 pilot prize: Completed, winners announced
  • 2024-25: Evaluator prizes ($6,500), recognition-based author awards (Flowing Water Scholar, Polaris Research)
  • 2026+: Monetary author prizes planned, funding dependent

Workshop Migration & Harmonization (Feb 2026)

What Was Done

Netlify Account Migration:

  • Migrated all 3 workshop sites from contact@unjournal.org account to daaronr nonprofit account
  • Created new sites with shorter URLs (uj-* prefix instead of unjournal-*)
  • Set up 301 redirects on old URLs to preserve any shared links

URL Mapping:

Old URL (contact account) New URL (nonprofit account)
unjournal-workshop.netlify.app uj-wellbeing-workshop.netlify.app
unjournal-pba-workshop.netlify.app uj-pba-workshop.netlify.app
unjournal-cultured-meat-workshop.netlify.app uj-cm-workshop.netlify.app

Harmonization Across All Workshops:

  • Recording section: Changed to softer language mentioning transcripts ("We hope to record... adjusting based on participant preferences")
  • Added header meta line to PBA with target date and duration
  • Added draft notice inside CM index form
  • Added Forecasting Tournament links to Wellbeing workshop
  • Added Coda PQ database links to CM workshop
  • Added Our World in Data link to CM beliefs (chicken slaughter data)
  • Fixed PBA beliefs "rank" instruction → "select credible approaches" (was using checkboxes, not ranking)
  • Standardized form field name to segment_priority_order (snake_case) across all workshops
  • Added error handling to form submissions (shows "Submitting..." state)
  • Enabled column selection for availability grid (click time headers to select entire column)

Current Status

Live Sites (nonprofit account - daaronr):

  • ✅ uj-wellbeing-workshop.netlify.app - deployed and working
  • ✅ uj-pba-workshop.netlify.app - deployed and working
  • ✅ uj-cm-workshop.netlify.app - deployed and working

Redirects (contact account):

  • ✅ Old URLs return 301 redirects to new URLs
  • ✅ Path preservation works (e.g., /thanks.html redirects to new /thanks.html)

Forms:

  • All 6 forms configured with data-netlify="true"
  • Forms dashboard: Log into Netlify with daaronr@gmail.com → Teams → daaronr → each project → Forms

Thank You Pages:

  • All /thanks.html and /beliefs-thanks.html pages return HTTP 200
  • Personalized greeting using sessionStorage

Pending / Next Steps

  1. Cancel $9/month plan on contact@unjournal.org account - After Feb 24 when it renews. The redirects will continue working as long as the account stays active (even on free tier).

  2. Verify form submissions in Netlify dashboard - Log into daaronr@gmail.com account, check Forms tab on each project to confirm test submissions were captured.

  3. Form detection on old sites - The old unjournal-* sites (contact account) have form detection enabled but may need a redeploy to detect forms. However, since they now redirect to new sites, this is not critical.

  4. Consider custom domain - Could set up wellbeing.unjournal.org etc. pointing to the Netlify sites for cleaner URLs.

Netlify CLI Notes

  • CLI authenticates via browser - make sure correct account is logged in before deploying
  • To check current login: npx netlify-cli status
  • To switch accounts: npx netlify-cli logout && npx netlify-cli login
  • SSH push may fail; use HTTPS as fallback: git remote set-url origin https://github.com/unjournal/unjournal_gitbook.git