Improve README and add CONTRIBUTING by JosephDenman · Pull Request #236 · LFDT-Minokawa/compact

JosephDenman · 2026-03-19T20:53:16Z

Rewrote README.md to be a clear, user-facing introduction to Compact -- explains what the language does, shows a real contract example, covers installation via the compact CLI, and links to documentation
Overhauled CONTRIBUTING.md with concrete build/test instructions for each component (compiler, CLI, VS Code extension, runtime), expand the generic contribution template with actionable developer setup steps
Removed outdated sections from the README (Docker registries, Nexus credentials, Nix permissions workarounds, release zip instructions) that no longer reflect how the project is distributed

Addresses issue #46

github-actions · 2026-03-19T20:54:05Z

Plugin Test Results

1 files 3 suites 1s ⏱️
21 tests 21 ✅ 0 💤 0 ❌
23 runs 23 ✅ 0 💤 0 ❌

Results for commit 4b3f3fe.

♻️ This comment has been updated with latest results.

README.md

github-actions · 2026-03-19T21:07:02Z

Compactc E2E Tests Results

2 825 tests - 12 175 2 825 ✅ - 12 175 5m 58s ⏱️ - 24m 1s
1 suites ± 0 0 💤 ± 0
1 files ± 0 0 ❌ ± 0

Results for commit 4b3f3fe. ± Comparison against base commit fd5310c.

This pull request removes 15000 and adds 2825 tests. Note that renamed tests count towards both.

src/tests/fuzzer.e2e.test.ts ‑ [E2E] Fuzzer tests for compiler > should be able to compile synthetic contract: 'assert_contract_0.compact'
src/tests/fuzzer.e2e.test.ts ‑ [E2E] Fuzzer tests for compiler > should be able to compile synthetic contract: 'assert_contract_1.compact'
src/tests/fuzzer.e2e.test.ts ‑ [E2E] Fuzzer tests for compiler > should be able to compile synthetic contract: 'assert_contract_10.compact'
src/tests/fuzzer.e2e.test.ts ‑ [E2E] Fuzzer tests for compiler > should be able to compile synthetic contract: 'assert_contract_100.compact'
src/tests/fuzzer.e2e.test.ts ‑ [E2E] Fuzzer tests for compiler > should be able to compile synthetic contract: 'assert_contract_101.compact'
src/tests/fuzzer.e2e.test.ts ‑ [E2E] Fuzzer tests for compiler > should be able to compile synthetic contract: 'assert_contract_102.compact'
src/tests/fuzzer.e2e.test.ts ‑ [E2E] Fuzzer tests for compiler > should be able to compile synthetic contract: 'assert_contract_103.compact'
src/tests/fuzzer.e2e.test.ts ‑ [E2E] Fuzzer tests for compiler > should be able to compile synthetic contract: 'assert_contract_104.compact'
src/tests/fuzzer.e2e.test.ts ‑ [E2E] Fuzzer tests for compiler > should be able to compile synthetic contract: 'assert_contract_105.compact'
src/tests/fuzzer.e2e.test.ts ‑ [E2E] Fuzzer tests for compiler > should be able to compile synthetic contract: 'assert_contract_106.compact'
…

src/tests/extracted.e2e.test.ts ‑ [E2E] Extracted unit tests for compiler > should be able to compile extracted contract: '/home/runner/work/_temp/nix-shell.W6EjZR/temp-test-aSg9FG/contract_0.compact'
src/tests/extracted.e2e.test.ts ‑ [E2E] Extracted unit tests for compiler > should be able to compile extracted contract: '/home/runner/work/_temp/nix-shell.W6EjZR/temp-test-aSg9FG/contract_1.compact'
src/tests/extracted.e2e.test.ts ‑ [E2E] Extracted unit tests for compiler > should be able to compile extracted contract: '/home/runner/work/_temp/nix-shell.W6EjZR/temp-test-aSg9FG/contract_10.compact'
src/tests/extracted.e2e.test.ts ‑ [E2E] Extracted unit tests for compiler > should be able to compile extracted contract: '/home/runner/work/_temp/nix-shell.W6EjZR/temp-test-aSg9FG/contract_100.compact'
src/tests/extracted.e2e.test.ts ‑ [E2E] Extracted unit tests for compiler > should be able to compile extracted contract: '/home/runner/work/_temp/nix-shell.W6EjZR/temp-test-aSg9FG/contract_1000.compact'
src/tests/extracted.e2e.test.ts ‑ [E2E] Extracted unit tests for compiler > should be able to compile extracted contract: '/home/runner/work/_temp/nix-shell.W6EjZR/temp-test-aSg9FG/contract_1001.compact'
src/tests/extracted.e2e.test.ts ‑ [E2E] Extracted unit tests for compiler > should be able to compile extracted contract: '/home/runner/work/_temp/nix-shell.W6EjZR/temp-test-aSg9FG/contract_1002.compact'
src/tests/extracted.e2e.test.ts ‑ [E2E] Extracted unit tests for compiler > should be able to compile extracted contract: '/home/runner/work/_temp/nix-shell.W6EjZR/temp-test-aSg9FG/contract_1003.compact'
src/tests/extracted.e2e.test.ts ‑ [E2E] Extracted unit tests for compiler > should be able to compile extracted contract: '/home/runner/work/_temp/nix-shell.W6EjZR/temp-test-aSg9FG/contract_1004.compact'
src/tests/extracted.e2e.test.ts ‑ [E2E] Extracted unit tests for compiler > should be able to compile extracted contract: '/home/runner/work/_temp/nix-shell.W6EjZR/temp-test-aSg9FG/contract_1005.compact'
…

♻️ This comment has been updated with latest results.

github-actions · 2026-03-19T21:07:15Z

Flaky Rate

Overall Flakiness	0.00% ±0

No current tests have flaky rates to display ✨

Github Test Reporter by CTRF 💚

Flaky Rate

Overall Flakiness	0.00% ±0

No current tests have flaky rates to display ✨

Github Test Reporter by CTRF 💚

github-actions · 2026-03-19T21:10:22Z

Compactc E2E Tests Results - macos-release-aarch64

1 files 48 suites 2m 0s ⏱️
467 tests 460 ✅ 7 💤 0 ❌
478 runs 471 ✅ 7 💤 0 ❌

Results for commit 949798c.

♻️ This comment has been updated with latest results.

github-actions · 2026-03-19T21:11:03Z

Compactc E2E Tests Results - linux-release-aarch64

1 files 48 suites 3m 24s ⏱️
467 tests 460 ✅ 7 💤 0 ❌
478 runs 471 ✅ 7 💤 0 ❌

Results for commit 949798c.

♻️ This comment has been updated with latest results.

github-actions · 2026-03-19T21:11:20Z

Compactc E2E Tests Results - linux-release-x86_64

1 files 48 suites 4m 0s ⏱️
467 tests 460 ✅ 7 💤 0 ❌
478 runs 471 ✅ 7 💤 0 ❌

Results for commit 949798c.

♻️ This comment has been updated with latest results.

github-actions · 2026-03-19T21:37:35Z

Compactc E2E Tests Results - macos-release-x86_64

1 files 48 suites 5m 41s ⏱️
467 tests 460 ✅ 7 💤 0 ❌
478 runs 471 ✅ 7 💤 0 ❌

Results for commit 949798c.

♻️ This comment has been updated with latest results.

kmillikin · 2026-03-23T12:45:47Z

CONTRIBUTING.md

+nix develop
+```
+
+This sets up `CHEZSCHEMELIBDIRS` and all required dependencies. The default shell includes Node.js, Yarn, and the runtime packages.


Just say that it "sets up environment variables" or the like. Users don't need to know the specific details and they inevitably get out of date.

kmillikin · 2026-03-23T12:47:09Z

CONTRIBUTING.md

 ```
-// This file is part of <REPLACE WITH REPOSITORY NAME>.
+// This file is part of Compact.
 // Copyright (C) 2025 Midnight Foundation


Copyright year is 2026, holder is "contributors to Minokawa Compact".

See: https://lf-hyperledger.atlassian.net/wiki/spaces/TSC/pages/21430874/Copyright+and+License+Policy#Copyright for the guidance.

kmillikin · 2026-03-23T12:51:11Z

CONTRIBUTING.md

 ```

-Where this is not possible, a copy of the Apache 2.0 or the repository's top-level LICENSE file in the same directory is required
+Adjust the comment syntax for the file type (e.g., `#` for shell scripts, `--` for Agda). Where comment headers are not possible, include a copy of the LICENSE file in the same directory.


e.g., ;;; for Scheme, # for shell scripts, and -- for Agda). We have not been following the guidance about including the LICENSE file. For example, compact/doc has files without a copyright notice and no LICENSE file. The LFDT guidance just has it at the top level: https://lf-decentralized-trust.github.io/governance/governing-documents/repository-structure/

kmillikin · 2026-03-23T12:52:07Z

CONTRIBUTING.md

+## Code of Conduct

-## Support and Communication:
+This project follows the [Contributor Covenant](./CODE_OF_CONDUCT.md). Please report any concerns to legal@midnight.foundation.


We follow the LFDT code of conduct: https://www.lfdecentralizedtrust.org/code-of-conduct

kmillikin · 2026-03-23T12:59:24Z

CONTRIBUTING.md


 ## Code Contribution Process

 * **Pull Requests:** Code contributions are submitted via Pull Requests.


I'd make this a numbered list, since some of them can't be done in any order.

github-actions · 2026-03-25T17:53:24Z

Plugin Test Summary

1 files 3 suites 1s ⏱️
21 tests 21 ✅ 0 💤 0 ❌
23 runs 23 ✅ 0 💤 0 ❌

Results for commit 15d9f9b.

♻️ This comment has been updated with latest results.

github-actions · 2026-03-25T18:00:46Z

Compactc E2E Test Summary

2 828 tests 2 828 ✅ 5m 26s ⏱️
1 suites 0 💤
1 files 0 ❌

Results for commit 15d9f9b.

♻️ This comment has been updated with latest results.

CONTRIBUTING.md

pataei · 2026-03-27T21:58:25Z

README.md

-# Compactc circuit compiler
+# Compact

-This project integrates with the Midnight Network.


I believe devrel complained that we don't have this and that's why we added it. So maybe we should keep it--unless I've been out of loop on it and they changed it again.

This line and phrasing in particular as the first sentence? I've just rephrased to "This is the home of Compact, the smart contract language for the Midnight blockchain."

I'm a confused about what we're supposed to be keeping.

I believe dev rel requires the specific sentencing, see #208. But I don't know the location of it.

README.md

@@ -1,298 +1,163 @@
-# Compactc circuit compiler
+# Compact


README.md

@@ -1,298 +1,163 @@
-# Compactc circuit compiler
+# Compact


README.md

@@ -1,298 +1,163 @@
-# Compactc circuit compiler
+# Compact


Signed-off-by: JosephDenman <joseph.denman@iohk.io>

JosephDenman requested review from a team as code owners March 19, 2026 20:53

github-advanced-security bot found potential problems Mar 19, 2026

View reviewed changes

README.md Fixed Show fixed Hide fixed

README.md Fixed Show fixed Hide fixed

README.md Fixed Show fixed Hide fixed

JosephDenman force-pushed the JosephDenman/improve-readme branch from 5ad3cd7 to f60cd9f Compare March 19, 2026 20:58

JosephDenman self-assigned this Mar 19, 2026

JosephDenman added documentation Improvements or additions to documentation release: 0.31 Expected April 14 run-release-workflow labels Mar 19, 2026

JosephDenman force-pushed the JosephDenman/improve-readme branch 2 times, most recently from 7702bff to 28d149e Compare March 19, 2026 22:04

kmillikin self-requested a review March 23, 2026 12:32

kmillikin requested changes Mar 23, 2026

View reviewed changes

kmillikin reviewed Mar 23, 2026

View reviewed changes

JosephDenman force-pushed the JosephDenman/improve-readme branch 2 times, most recently from 4b3f3fe to 0829995 Compare March 25, 2026 17:52

JosephDenman mentioned this pull request Mar 26, 2026

Fix Scorecard #261

Merged

JosephDenman force-pushed the JosephDenman/improve-readme branch from 0829995 to 949798c Compare March 26, 2026 18:19

pataei removed the run-release-workflow label Mar 27, 2026

pataei reviewed Mar 27, 2026

View reviewed changes

CONTRIBUTING.md Show resolved Hide resolved

pataei reviewed Mar 27, 2026

View reviewed changes

README.md Show resolved Hide resolved

github-advanced-security bot found potential problems Mar 27, 2026

View reviewed changes

JosephDenman force-pushed the JosephDenman/improve-readme branch from 5f0391d to 761910a Compare April 1, 2026 14:50

JosephDenman added 2 commits April 1, 2026 10:34

Improve README and add CONTRIBUTING

a069119

Signed-off-by: JosephDenman <joseph.denman@iohk.io>

Parisa feedback

296526b

Signed-off-by: JosephDenman <joseph.denman@iohk.io>

JosephDenman force-pushed the JosephDenman/improve-readme branch from e82304b to 296526b Compare April 1, 2026 15:34

Satisfy devrel

15d9f9b

Signed-off-by: JosephDenman <joseph.denman@iohk.io>


		## Code Contribution Process

		* Pull Requests: Code contributions are submitted via Pull Requests.

Conversation

JosephDenman commented Mar 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Mar 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Plugin Test Results

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Mar 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Compactc E2E Tests Results

Uh oh!

github-actions bot commented Mar 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Flaky Rate

Flaky Rate

Uh oh!

github-actions bot commented Mar 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Compactc E2E Tests Results - macos-release-aarch64

Uh oh!

github-actions bot commented Mar 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Compactc E2E Tests Results - linux-release-aarch64

Uh oh!

github-actions bot commented Mar 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Compactc E2E Tests Results - linux-release-x86_64

Uh oh!

github-actions bot commented Mar 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Compactc E2E Tests Results - macos-release-x86_64

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

kmillikin Mar 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Mar 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Plugin Test Summary

Uh oh!

github-actions bot commented Mar 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Compactc E2E Test Summary

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Check failure

Check warning

Check warning

Reviewers

JosephDenman commented Mar 19, 2026 •

edited

Loading

github-actions bot commented Mar 19, 2026 •

edited

Loading

github-actions bot commented Mar 19, 2026 •

edited

Loading

github-actions bot commented Mar 19, 2026 •

edited

Loading

github-actions bot commented Mar 19, 2026 •

edited

Loading

github-actions bot commented Mar 19, 2026 •

edited

Loading

github-actions bot commented Mar 19, 2026 •

edited

Loading

github-actions bot commented Mar 19, 2026 •

edited

Loading

kmillikin Mar 23, 2026 •

edited

Loading

github-actions bot commented Mar 25, 2026 •

edited

Loading

github-actions bot commented Mar 25, 2026 •

edited

Loading