Skip to content

docs: submit challenges as a reprex - #1

Open
drmowinckels wants to merge 2 commits into
mainfrom
docs/reprex-submissions
Open

docs: submit challenges as a reprex#1
drmowinckels wants to merge 2 commits into
mainfrom
docs/reprex-submissions

Conversation

@drmowinckels

Copy link
Copy Markdown
Member

Summary

Reworks the community contribution model so challenges are submitted as a reprex (via the reprex package) rather than free-text task/example/solution fields.

Why: a reprex guarantees each challenge is well-stated in runnable R — no ambiguous, prose-only puzzles. It carries the premise (setup + what to write) and the expected outcome (printed output, or an image for visual challenges) in one reproducible block.

  • Issue form — the reprex is the single required content field. Reference solution + tests are now optional (they help review/verification but aren't needed to submit). No working solution required in the reprex itself.
  • CONTRIBUTING — a short Write your challenge as a reprex walk-through with a worked example, plus a note on visual challenges (attach the target image; keep the plotting code — the answer — to yourself).
  • architecture — records that community challenges are reprex-shaped while AI drafts are structured fields, and both coexist in the queue (the post step renders whichever shape a challenge has).

For review

  • Does this match what you had in mind for the submission format?
  • Open question it surfaces for slice 3 (the post cron): it now needs to render two shapes — a community reprex block, or Jinx's structured prompt+sample. Worth deciding whether Jinx should eventually emit a reprex-style statement too, for one uniform shape.

🤖 Generated with Claude Code

Athanasia Monika Mowinckel and others added 2 commits August 5, 2026 17:58
Community challenges are now submitted as a reprex (reprex package) rather than
free-text task/example/solution fields. A reprex guarantees the challenge is
well-stated in runnable R: it carries the premise (setup + what to write) and
the expected outcome (printed output or an image) in one reproducible block. No
working solution required — reference solution and tests are optional.

- issue form: reprex is the one required content field; solution + tests optional.
- CONTRIBUTING: "Write your challenge as a reprex" walk-through + visual-challenge note.
- architecture: community = reprex-shaped, AI drafts = structured fields; both coexist.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
With Jinx now generating a reprex statement (not prompt+sample), every
challenge — community or AI — posts in one shape: a rendered reprex statement,
with solution/tests hidden. The post step has a single shape to render.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant