-
Notifications
You must be signed in to change notification settings - Fork 21
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
Doc: update development instructions #84
Conversation
Will rebase this on #82 as soon as it gets merged |
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.
LGTM, but I'd try to clarify the following
README.md
Outdated
@@ -37,9 +45,9 @@ To run it locally you can run: | |||
```sh | |||
make serve | |||
``` | |||
(Do it every time you modify something in the sources to re-generate the `server/asset/asset.go` file, the dashboard api, and to serve the updated dashboard itself) | |||
It will take care of re-generateing the assets file, building dashboard api, and to serving the updated dashboard itself. |
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.
This command is useful if you want to locally launch the dashboard
This command is not appropriate to develop in the dashboard because it is needed to stop and re-run it again everytime you modify whatever.
README.md
Outdated
docker run -p 8080:80 --link bblfsh bblfsh/dashboard -bblfsh-addr bblfsh:9432 | ||
``` | ||
|
||
Please read the [getting started](https://doc.bblf.sh/user/getting-started.html) guide, to learn more about how to use and deploy a bblfsh server. | ||
Please read the [getting started](https://doc.bblf.sh/user/getting-started.html) guide, to learn more about how to use and deploy a bblfsh server, install drivers, etc. | ||
|
||
If don't want to run **dashboard** using our *Docker* image you can download a binary from [releases](https://github.com/bblfsh/dashboard/releases) page. |
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.
If you do so, you will also need a bblfsh/bblfsdh running
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.
Sorry, I'm a bit confused - do you mean that a notice about bblfshd needs to be added to the last sentence, about binary releases?
@bzz you added some useful info with this PR. Could you rebase over |
510687d
to
5b5c8a5
Compare
Signed-off-by: Alexander Bezzubov <[email protected]>
@dpordomingo sorry for delay. Done. |
@dpordomingo friendly ping |
Merged, thanks for pinging |
Minor drive-by update of the README to avoid confusing first-time users/developers giving it a try.
It also documents minimum requirements.