Skip to content
This repository has been archived by the owner on Jan 2, 2025. It is now read-only.

Update to Readme (fixes #1) #29

Merged
merged 3 commits into from
Aug 19, 2019
Merged

Update to Readme (fixes #1) #29

merged 3 commits into from
Aug 19, 2019

Conversation

bburns632
Copy link
Contributor

As raised in #1 , the README was a little confusing for a new user. This PR mainly:

  1. Adds a description at the top of the readme
  2. Fixes a typo in the docker code
  3. Makes minor formatting changes

Another major assumption is that the quotes were placeholders. This PR can be modified with those back in if that was a mistake.

@bburns632 bburns632 requested a review from Chronocook August 19, 2019 14:43
@bburns632 bburns632 force-pushed the feature/READMEupdate branch from e808e6d to f2d276c Compare August 19, 2019 14:46
Copy link
Collaborator

@jameslamb jameslamb left a comment

Choose a reason for hiding this comment

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

Looks good! Just recommended a few small changes.


```bash
docker build -t groundhog -f Dockerfile .
docker build -t groundhog -f Dockerfile-app .
Copy link
Collaborator

Choose a reason for hiding this comment

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

we have #5 so this will get reverted, but I like the idea of leaving that alone for someone who is less familiar with open source to pick up as a "good first issue".

So I support the change in this PR.

README.md Outdated
@@ -37,6 +39,10 @@ To stop the container by name (if you used the `--name` tag when launching it),
docker stop groundhog_server
```

***
## Clients
With the docker container running, choose a client to get and append elevation data to your dataset.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Nothing about the clients relies on the fact that the app is running in .a container. It could just as easily be running on some dedicated server.

Can you change With the docker container running, to Given a running instance of the service,?

# groundhog
`groundhog` is a service and client libraries to access NASA's publicly available surface elevation data, [SRTM](https://www2.jpl.nasa.gov/srtm/). Given a table with GPS information, this package provides utilities to enrich that dataset with elevation and slope features. Just load the container and one of the clients, and you're all set!
Copy link
Collaborator

Choose a reason for hiding this comment

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

could you put a blank line between headings and their body content?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

added

@bburns632 bburns632 force-pushed the feature/READMEupdate branch from f2d276c to d2fc182 Compare August 19, 2019 18:48
@bburns632
Copy link
Contributor Author

@jameslamb , good suggestions. Here's a revised PR.

Copy link
Collaborator

@jameslamb jameslamb left a comment

Choose a reason for hiding this comment

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

looks good!

@jameslamb jameslamb merged commit 4a6d01a into master Aug 19, 2019
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.

2 participants