Skip to content

docs: improve readme #357

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Sep 26, 2024
Merged

docs: improve readme #357

merged 5 commits into from
Sep 26, 2024

Conversation

BrunoQuaresma
Copy link
Contributor

@BrunoQuaresma BrunoQuaresma self-assigned this Sep 25, 2024
Copy link
Member

@matifali matifali left a comment

Choose a reason for hiding this comment

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

A few suggestion but LGTM

Copy link
Member

Choose a reason for hiding this comment

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

Do we have SVGs for these?

Comment on lines +99 to +105
| Name | Description | Known Issues |
| ------------------------ | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
| Volume mounts | Volumes are used to persist data and share directories between the host and container. | [#220](https://github.com/coder/envbuilder/issues/220) |
| Port forwarding | Port forwarding allows exposing container ports to the host, making services accessible. | [#48](https://github.com/coder/envbuilder/issues/48) |
| Script init & Entrypoint | `init` adds a tiny init process to the container, and `entrypoint` sets a script to run at container startup. | [#221](https://github.com/coder/envbuilder/issues/221) |
| Customizations | Product-specific properties, e.g., _VS Code_ settings and extensions. | [#43](https://github.com/coder/envbuilder/issues/43) |
| Composefile | Define multiple containers and services for more complex development environments. | [#236](https://github.com/coder/envbuilder/issues/236) |
Copy link
Member

Choose a reason for hiding this comment

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

We should make sure we keep this table updated as the issues gets resolved.

- `build`: Builds and tags `envbuilder:latest` for your current architecture.
- `develop`: Runs `envbuilder:latest` against a sample Git repository.
- `test`: Runs tests.
- `test-registry`: Stands up a local registry for caching images used in tests.
Copy link
Member

Choose a reason for hiding this comment

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

Missing docs target?

@BrunoQuaresma BrunoQuaresma merged commit 63a383b into main Sep 26, 2024
4 checks passed
@BrunoQuaresma BrunoQuaresma deleted the bq/improve-readme branch September 26, 2024 17:38
@matifali
Copy link
Member

Also closes #328

@matifali matifali linked an issue Sep 30, 2024 that may be closed by this pull request
@matifali matifali mentioned this pull request Sep 30, 2024
mafredri pushed a commit that referenced this pull request Oct 2, 2024
Co-authored-by: Cian Johnston <[email protected]>
Co-authored-by: Muhammad Atif Ali <[email protected]>
(cherry picked from commit 63a383b)
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.

Envbuilder: tweak README page README & docs refresh
3 participants