Skip to content

docs: update README to reflect docker-opam-action rename#107

Open
Justme0606 wants to merge 1 commit into
masterfrom
doc/update-documentation
Open

docs: update README to reflect docker-opam-action rename#107
Justme0606 wants to merge 1 commit into
masterfrom
doc/update-documentation

Conversation

@Justme0606

Copy link
Copy Markdown
Collaborator

No description provided.

@Justme0606 Justme0606 requested a review from Zimmi48 April 30, 2026 11:01

@Zimmi48 Zimmi48 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I noticed a few things that would need to be updated, although not all of them are related to this PR, so feel free to delay some of these changes to a later PR. The comments that are most relevant to the current PR are the one on the title, and those related to the contributing guide and code of conduct.

Comment thread README.md
[example-link]: https://github.com/erikmd/docker-coq-github-action-demo

[contributing-shield]: https://img.shields.io/badge/contributions-welcome-%23f7931e.svg
[contributing-link]: https://github.com/coq-community/manifesto/blob/master/CONTRIBUTING.md

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This link should be removed or replaced.

Comment thread README.md
[contributing-link]: https://github.com/coq-community/manifesto/blob/master/CONTRIBUTING.md

[conduct-shield]: https://img.shields.io/badge/%E2%9D%A4-code%20of%20conduct-%23f15a24.svg
[conduct-link]: https://github.com/coq-community/manifesto/blob/master/CODE_OF_CONDUCT.md

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same. In this case, we can point to https://rocq-prover.org/policies/code-of-conduct.

Comment thread README.md
| | GitHub repo | Type | Docker Hub |
| --- | ----------------------------------------------------------------------- | ------------- | ---------------------------------------------------------------- |
| ⊙ | [docker-opam-action](https://github.com/rocq-prover/docker-opam-action) | GitHub Action | N/A |
| ↳ | [docker-rocq](https://github.com/coq-community/docker-rocq) | Dockerfile | [`rocq/rocq-prover`](https://hub.docker.com/r/rocq/rocq-prover/) |

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
|| [docker-rocq](https://github.com/coq-community/docker-rocq) | Dockerfile | [`rocq/rocq-prover`](https://hub.docker.com/r/rocq/rocq-prover/) |
|| [docker-rocq](https://github.com/rocq-community/docker-rocq) | Dockerfile | [`rocq/rocq-prover`](https://hub.docker.com/r/rocq/rocq-prover/) |

Comment thread README.md
| --- | ----------------------------------------------------------------------- | ------------- | ---------------------------------------------------------------- |
| ⊙ | [docker-opam-action](https://github.com/rocq-prover/docker-opam-action) | GitHub Action | N/A |
| ↳ | [docker-rocq](https://github.com/coq-community/docker-rocq) | Dockerfile | [`rocq/rocq-prover`](https://hub.docker.com/r/rocq/rocq-prover/) |
| ↳ | [docker-base](https://github.com/coq-community/docker-base) | Dockerfile | [`rocq/base`](https://hub.docker.com/r/rocq/base/) |

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
|| [docker-base](https://github.com/coq-community/docker-base) | Dockerfile | [`rocq/base`](https://hub.docker.com/r/rocq/base/) |
|| [docker-base](https://github.com/rocq-community/docker-base) | Dockerfile | [`rocq/base`](https://hub.docker.com/r/rocq/base/) |

Comment thread README.md
| ↳ | Debian | Linux distro | [`debian`](https://hub.docker.com/_/debian/) |

For more details about these images, see the
[docker-coq wiki](https://github.com/coq-community/docker-coq/wiki).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
[docker-coq wiki](https://github.com/coq-community/docker-coq/wiki).
[docker-coq wiki](https://github.com/rocq-community/docker-coq/wiki).

Comment thread README.md
@@ -1 +1 @@
# Docker-Coq GitHub Action

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
# Docker-Opam GitHub Action

Comment thread README.md
The `docker-coq-action` provides built-in support for `opam` builds.
The `docker-opam-action` provides built-in support for `opam` builds.

`coq` is built on-top of `ocaml` and so `coq` projects use `ocaml`'s

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
`coq` is built on-top of `ocaml` and so `coq` projects use `ocaml`'s
Rocq is built on-top of OCaml and so Rocq projects use OCaml's

Comment thread README.md
This GitHub Action supports `opam` out of the box.
If your project does not already have a `coq-….opam` file, you might
generate one such file by using the corresponding template gathered in
[coq-community/templates](https://github.com/coq-community/templates#readme).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
[rocq-community/templates](https://github.com/rocq-community/templates#readme).

Comment thread README.md
[coq-community/templates](https://github.com/coq-community/templates#readme).

This `.opam` file can then serve as a basis for submitting releases in
[coq/opam-coq-archive](https://github.com/coq/opam-coq-archive), and

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
[rocq-prover/opam](https://github.com/rocq-prover/opam) repository, and

Comment thread README.md
This `.opam` file can then serve as a basis for submitting releases in
[coq/opam-coq-archive](https://github.com/coq/opam-coq-archive), and
related guidelines (including the required **`.opam` metadata**) are
available in <https://coq.inria.fr/opam-packaging.html>.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
available in <https://rocq-prover.org/docs/opam-packaging>.

Comment thread README.md

The supported compilers w.r.t. each version of Coq are documented in the
[OCaml-versions policy](https://github.com/coq-community/docker-coq/wiki#ocaml-versions-policy) section of the `docker-coq` wiki.
[OCaml-versions policy](https://github.com/rocq-prover/docker-coq/wiki#ocaml-versions-policy) section of the `docker-coq` wiki.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This link shouldn't have been changed (until this wiki moves elsewhere).

Comment thread README.md
#### `opam_file`

*Optional*
_Optional_

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

BTW, you have a lot of spurious changes in the diff like this one. If you can configure your auto-formatter to use * instead of _ for italic, it would reduce significantly the size of the diff.

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.

2 participants