Skip to content
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

docs(vscode): high level devcontainer quickstart documentation #3723

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

zondervancalvez
Copy link
Contributor

Commit to be reviewed

docs(vscode): high level devcontainer quickstart documentation

Primary Changes
----------------
1. Added a documentation describing how to get
started by opening the repo within the docker container
and by cloning the repo to a docker volume

Fixes #874

Pull Request Requirements

  • Rebased onto upstream/main branch and squashed into single commit to help maintainers review it more efficient and to avoid spaghetti git commit graphs that obfuscate which commit did exactly what change, when and, why.
  • Have git sign off at the end of commit message to avoid being marked red. You can add -s flag when using git commit command. You may refer to this link for more information.
  • Follow the Commit Linting specification. You may refer to this link for more information.

Character Limit

  • Pull Request Title and Commit Subject must not exceed 72 characters (including spaces and special characters).
  • Commit Message per line must not exceed 80 characters (including spaces and special characters).

A Must Read for Beginners
For rebasing and squashing, here's a must read guide for beginners.

BUILD.md Outdated
@@ -40,6 +41,39 @@ The `npm run watch` script in action:

## Getting Started

### Quickstart with VSC Devcontainer for Hyperledger Cactus

* Opening the Repo Within a Docker Container
Copy link
Contributor

Choose a reason for hiding this comment

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

Please make 'R' small here (repo)

BUILD.md Outdated
* Opening the Repo Within a Docker Container
* Install Prerequisites:
* Visual Studio Code (VSC)
* Docker Desktop (ensure it's running) https://docs.docker.com/engine/install/
Copy link
Contributor

Choose a reason for hiding this comment

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

A link to Docker Desktop should be present here instead of Docker Engine

BUILD.md Outdated
* Open in VSC and Reopen in Container:
* Launch VSC
* Open the cacti folder
* Press Ctrl+Shift+P → Select Reopen in Container.
Copy link
Contributor

Choose a reason for hiding this comment

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

Instead use this Press F1 and type "Dev Containers: Open Folder in Container.."

BUILD.md Outdated
* Press Ctrl+Shift+P → Select Reopen in Container.
* Wait for the Container Setup:
* The devcontainer will install all required dependencies inside the container.
* Cloning the Repo to a Docker Volume
Copy link
Contributor

Choose a reason for hiding this comment

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

From Line 62 to Line 72 is not required

Copy link
Contributor

Choose a reason for hiding this comment

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

For showcasing how to run Cacti from a docker volume, create a sub-section instead stating how to attach the docker volume containing Hyperledger Cacti to the running VSC container

BUILD.md Show resolved Hide resolved
@zondervancalvez zondervancalvez force-pushed the zondervancalvez/issue874 branch 3 times, most recently from 5737283 to 136c65b Compare January 28, 2025 07:51
BUILD.md Outdated Show resolved Hide resolved
Primary Changes
----------------
1. Added a documentation describing how to get
started by opening the repo within the docker container
and by cloning the repo to a docker volume

Fixes hyperledger-cacti#874

Signed-off-by: bado <[email protected]>
@zondervancalvez zondervancalvez force-pushed the zondervancalvez/issue874 branch from 136c65b to ab03474 Compare January 28, 2025 08:00
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.

docs(vscode): high level devcontainer quickstart documentation
2 participants