-
Notifications
You must be signed in to change notification settings - Fork 5.7k
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
ref: improving development environment and instructions #5180
Conversation
DEVELOPMENT.md
Outdated
|
||
### Option 1 (Preferred): Use a Dev Container | ||
|
||
Open this repostiory as a Dev Container per your IDEs instructions. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Open this repostiory as a Dev Container per your IDEs instructions. | |
Open this repository as a Dev Container per your IDEs instructions. |
DEVELOPMENT.md
Outdated
* **`make`**: The project uses `make` to coordidinate packaging. | ||
* **`uv`**: This project uses `uv` (`>=0.4`), a Python package and project manager from Astral. Install instructions at https://docs.astral.sh/uv/getting-started/installation/. | ||
* **`npm`**: The frontend files are built with Node.js (`v22.12 LTS`) and `npm` (`v10.9`). Install instrucations at https://nodejs.org/en/download/package-manager. | ||
* Windows (WSL) users: ensure `npm` is installed within WSL environment; `which npm` should resolve to a Linux location, not a Windows location. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe there's an extra space here?
* Windows (WSL) users: ensure `npm` is installed within WSL environment; `which npm` should resolve to a Linux location, not a Windows location. | |
* Windows (WSL) users: ensure `npm` is installed within WSL environment; `which npm` should resolve to a Linux location, not a Windows location. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I've switched this to a -
, it is meant to be an indented sublist as it applies to npm
but only Windows users.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hey @mieslep
Incredible. This looks great!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
One thing I would add to this is that we have debug configuration for VSCode and the developer can run it by pressing F5 in the editor or going to the debug tab.
@ogabrielluiz edits pushed! |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Copilot reviewed 4 out of 8 changed files in this pull request and generated 1 suggestion.
Files not reviewed (4)
- .devcontainer/Dockerfile: Language not supported
- .devcontainer/demo/devcontainer.json: Language not supported
- .devcontainer/devcontainer.json: Language not supported
- Makefile: Language not supported
Co-authored-by: Copilot <[email protected]>
This PR improves the ability for contributors to build and test changes, including better support for Windows users.
devcontainer
more closely-aligned with CI/CD container definitionDEVELOPMENT.md
and expandedMakefile