Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Add create-basis/process example to tools.build docs

Open Beginner friendly
#538 3 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
65/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Quiet
Tech stack
clojure
Domain
documentation

Research direction

Start with the tools.build guide and identify where build-script examples using -T belong. Add a canonical example combining create-basis, java-command, and process to run Cognitect's test-runner with the required classpath, then verify that the guide clearly explains the invocation and expected result.

Written by the indexing model from the issue text.

Description

Per discussion on Slack about using clojure.tools.build to run tests that need a particular classpath, including the test runner itself, Alex said "you can use a combo of create-basis, java-command, and process to execute it".

It would be great if the tools.build guide had an example of doing this with Cognitect's test-runner to provide a canonical example of how to do this in a build script (where the build script is invoked as the only dependency via -T).

Dominant language
HTML
Stars
259
Forks
275
No merged PRs in 30d

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from clojure/clojure-site

All issues in clojure/clojure-site

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.