Skip to content

Commit

Permalink
Update contributing steps (#228)
Browse files Browse the repository at this point in the history
  • Loading branch information
DavidSouther authored Feb 12, 2024
1 parent 235d53e commit 57104c3
Show file tree
Hide file tree
Showing 2 changed files with 7 additions and 11 deletions.
16 changes: 6 additions & 10 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,21 +4,17 @@
- [Source](https://github.com/nand2tetris/web-ide)
- [Issues](https://github.com/nand2tetris/web-ide/issues)

## Set up and Run
## Dependencies and Environment

```
# Set up
git clone
npm install
The Nand2Tetris Web IDE is developed in the TypeScript programming language and run on the NodeJS platform. Running the IDE and tests locally requires having `node`, `npm`, and `npx`. We recommend installing all three, as well as keeping them updated, by using the [`nvm` tool](https://github.com/nvm-sh/nvm).

# Run
npm run build
npm start
```
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
```

Will install all dependencies & begin the development server on https://localhost:8080.
The source code is version controlled using `git`, which should be installed using the recommended way depending on your operating system. Issues, pull requests, and other project management is conducted on [GitHub](https://github.com/nand2tetris/web-ide). When developing to contribute a feature, we recommend creating a fork, cloning from your fork, creating a new branch with `git switch -c`, pushing that branch to your fork, and creating a pull request from that branch to main. See documentation on GitHub and the internet for more details.

Automated tests run at https://localhost:8080/tests, and by clicking the "Tests" link on the top right nav bar.
After cloning the repository, to install all dependencies, `cd` to the downloaded folder and run `npm install`. To update the compiled TypeScript libraries after making any changes in `simulator`, `projects`, or `components`, run `npm run build`. Alternatively, to only build one of those three, run `npm run build -w <name>`. To run all tests, run `npm test`; for tests in just one part of the project, `npm test -w <name>`. After building the libraries, you can run the web IDE with `npm run web`. This will begin the development server on https://localhost:8080.

## Issues & Pull Requests

Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ A Javascript reimplementation of the software suite described in www.nand2tetris

Presently the implementation focuses on the Hardware Simulator (projects 1, 2, 3, 5). The CPU and the VM Emulators will be next. The goal is to allow students complete the projects using modern, web-based tools, without having to download code to their computers.

Users can work with the tools via a web IDE, or via a VS Code extension. Both are decsribed below.
Users can work with the tools via a web IDE, or via a VS Code extension. Both are described below.

## User Guide

Expand Down

0 comments on commit 57104c3

Please sign in to comment.