Skip to content
This repository has been archived by the owner on Aug 1, 2022. It is now read-only.

Expand DEVELOPMENT proxy section #192

Merged
merged 10 commits into from
Mar 4, 2020
Merged

Conversation

xla
Copy link
Contributor

@xla xla commented Feb 26, 2020

Closes #191

@xla xla self-assigned this Feb 26, 2020
Copy link
Member

@rudolfs rudolfs left a comment

Choose a reason for hiding this comment

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

Nice work!! ⚡️

Inlined some wording suggestions.

DEVELOPMENT.md Outdated Show resolved Hide resolved
DEVELOPMENT.md Outdated Show resolved Hide resolved
DEVELOPMENT.md Outdated Show resolved Hide resolved
DEVELOPMENT.md Outdated Show resolved Hide resolved
DEVELOPMENT.md Outdated Show resolved Hide resolved
Co-Authored-By: Rūdolfs Ošiņš <[email protected]>
Copy link
Contributor

@NunoAlexandre NunoAlexandre left a comment

Choose a reason for hiding this comment

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

Nice, @xla!

Just a few comments.

DEVELOPMENT.md Outdated Show resolved Hide resolved
DEVELOPMENT.md Outdated Show resolved Hide resolved
DEVELOPMENT.md Outdated Show resolved Hide resolved
DEVELOPMENT.md Outdated Show resolved Hide resolved
DEVELOPMENT.md Show resolved Hide resolved
Copy link
Contributor

@MeBrei MeBrei left a comment

Choose a reason for hiding this comment

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

Looks great so far! Just 2 suggestions

DEVELOPMENT.md Outdated Show resolved Hide resolved
DEVELOPMENT.md Outdated Show resolved Hide resolved
DEVELOPMENT.md Outdated Show resolved Hide resolved
yarn prettier:check # Check UI code formatting
yarn prettier:write # Auto-format UI code
yarn lint # Check UI code for linting errors
```
Copy link
Member

Choose a reason for hiding this comment

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

We also have a bunch of helper scripts for the proxy in our package.json, should we maybe include those here too with proper descriptions?

proxy:build          # cd proxy && cargo build --all-features --all-targets
proxy:build:release  # cd proxy && cargo build --release --all-features --all-targets
proxy:build:test     # cd proxy && cargo test --no-run
proxy:start          # cd proxy && cargo run --release -- --registry=emulator
proxy:start:test     # cd proxy && cargo run -- --registry=emulator --test

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Generally I find these outputs of cli options to be prone to quickly get outdated. I'd rather show a command which shows all the commands.

Copy link
Member

Choose a reason for hiding this comment

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

I know what you mean. This section expands a bit on the commands however. It's meant to explain when they should be used. As the yarn run command can only show the commands themselves, but there is no way to inline documentation in package.json.

I just provided the # cd proxy && cargo run comments as a reference, the idea was that you'd write the explanation in a comment...

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Addressed in 4b037b7

Copy link
Contributor

@garbados garbados left a comment

Choose a reason for hiding this comment

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

I left some comments and suggestions about writing style, but for the most part this is a welcome expansion on the norms and procedures of working on the app/proxy.

@xla xla dismissed NunoAlexandre’s stale review March 4, 2020 13:38

Cocnerns addressed.

@xla xla requested a review from rudolfs March 4, 2020 13:40
@xla xla dismissed rudolfs’s stale review March 4, 2020 13:51

Feedback addressed.

Copy link
Member

@rudolfs rudolfs left a comment

Choose a reason for hiding this comment

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

Some final touches.

Also could we wrap the paragraphs at 80 characters? VIM's gq is quite handy for that.

DEVELOPMENT.md Outdated Show resolved Hide resolved
DEVELOPMENT.md Outdated Show resolved Hide resolved
DEVELOPMENT.md Outdated Show resolved Hide resolved
DEVELOPMENT.md Outdated Show resolved Hide resolved
Copy link
Member

@rudolfs rudolfs left a comment

Choose a reason for hiding this comment

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

LGTM 🚀

@xla xla merged commit a085f53 into master Mar 4, 2020
@xla xla deleted the xla/191-extend-proxy-development branch March 4, 2020 14:12
rudolfs pushed a commit that referenced this pull request Mar 4, 2020
Closes #191

* Correct flag
* Apply suggestions from @rudolfs
Co-Authored-By: Rūdolfs Ošiņš <[email protected]>

* Apply suggestions from code review
Co-Authored-By: Merle Breitkreuz <[email protected]>
Co-Authored-By: Rūdolfs Ošiņš <[email protected]>

* Link downstream protocol projects
* Improve languag
* Correct position of test disclaimerj
* Add proxy commands with explanations
* Address feedback
Co-authored-by: Rūdolfs Ošiņš <[email protected]>
Co-authored-by: Merle Breitkreuz <[email protected]>
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Extend DEVELOPMENT with proxy info
5 participants