Skip to content

Add tutorial: Managing Dependencies with Dune (dune pkg)#3581

Open
cuihtlauac wants to merge 2 commits into
mainfrom
tutorial-dune-pkg
Open

Add tutorial: Managing Dependencies with Dune (dune pkg)#3581
cuihtlauac wants to merge 2 commits into
mainfrom
tutorial-dune-pkg

Conversation

@cuihtlauac
Copy link
Copy Markdown
Collaborator

Summary

  • New tutorial data/tutorials/platform/0_10_dune_pkg.md covering Dune's built-in package management
  • Covers the full workflow: dune pkg lock, lock directory, building, updating, adding/removing deps
  • Explains how dune pkg interacts with opam switches (compiler from opam, libraries from dune)
  • Section on LLM coding agents: dune pkg simplifies agent workflows to just dune build
  • Comparison table: dune pkg vs opam (maturity, features, CI/agent suitability)
  • Troubleshooting section
  • Adds "dune-pkg" to opam-path's recommended_next_tutorials

Independent of #3580 (the opam-path rewrite). Can be merged in any order — each branch works against current main.

Test plan

  • make build succeeds (tutorial frontmatter parsing, cross-reference validation)
  • Review rendered page at /docs/dune-pkg
  • Verify prerequisite links to /docs/managing-dependencies and /docs/opam-path work

🤖 Generated with Claude Code

cuihtlauac and others added 2 commits March 26, 2026 08:52
New tutorial covering dune's built-in package management (dune pkg):

- Lock directory workflow: dune pkg lock, version control, updating
- Building with locked dependencies (single dune build command)
- Adding/removing dependencies
- Using dune pkg alongside opam switches
- Why dune pkg is ideal for LLM coding agents
- Comparison table: dune pkg vs opam workflows
- Troubleshooting common issues

Also adds "dune-pkg" as recommended_next_tutorials in the
opam-path tutorial.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- MD014: Remove `$ ` prefix from shell code blocks without output
- MD036: Convert bold pseudo-headings to ### headings in Troubleshooting
- MD040: Add `dune` language tag to bare code block

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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