Following #687, I asked Claude what it thought was still lacking on the contributing docs page, and it said:
A few things that stand out to me as gaps, roughly in order of how much they'd help newcomers:
- Dev environment setup - There's nothing on how to actually get started developing. Cloning a repo,
Pkg.dev-ing a local copy, running it locally. For someone who's never contributed to a Julia package
before, this is the first wall they'd hit.
- Codebase / ecosystem overview - The Turing ecosystem is split across many packages (Turing.jl,
DynamicPPL.jl, AbstractMCMC.jl, Bijectors.jl, etc.). A page explaining what lives where and how they
relate would save contributors a lot of orientation time. The Developers section covers internals, but
there's no high-level map.
- How to add a docs page - The Documentation page explains where docs live, but not the practical
steps: how to add a new Quarto page, preview locally, add it to the sidebar, etc. Given that docs
contributions are probably the most accessible entry point, this seems valuable.
- Good first issues - The Getting Involved page links to the issue tracker but doesn't mention whether
there's a good-first-issue label or similar. Pointing people to a filtered issue list would lower the
barrier a lot.
which I broadly agree with. (I mean, (2) is pretty much something I suggested ages ago #606)
Following #687, I asked Claude what it thought was still lacking on the contributing docs page, and it said:
which I broadly agree with. (I mean, (2) is pretty much something I suggested ages ago #606)