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

Doc: update development instructions #84

Merged
merged 1 commit into from
Apr 3, 2018
Merged

Conversation

bzz
Copy link
Contributor

@bzz bzz commented Dec 12, 2017

Minor drive-by update of the README to avoid confusing first-time users/developers giving it a try.
It also documents minimum requirements.

@bzz
Copy link
Contributor Author

bzz commented Dec 12, 2017

Will rebase this on #82 as soon as it gets merged

Copy link
Member

@dpordomingo dpordomingo left a 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.
Copy link
Member

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.
Copy link
Member

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

Copy link
Contributor Author

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?

@dpordomingo
Copy link
Member

@bzz you added some useful info with this PR. Could you rebase over src-d/master and merge? ☺️

@bzz bzz force-pushed the patch-1 branch 2 times, most recently from 510687d to 5b5c8a5 Compare January 15, 2018 12:00
Signed-off-by: Alexander Bezzubov <[email protected]>
@bzz
Copy link
Contributor Author

bzz commented Jan 15, 2018

@dpordomingo sorry for delay. Done.

@bzz
Copy link
Contributor Author

bzz commented Apr 3, 2018

@dpordomingo friendly ping

@dpordomingo dpordomingo merged commit 6bcc10e into bblfsh:master Apr 3, 2018
@dpordomingo
Copy link
Member

Merged, thanks for pinging

@bzz bzz deleted the patch-1 branch April 6, 2018 08:40
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.

2 participants