-
Notifications
You must be signed in to change notification settings - Fork 15
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
update readme #25
update readme #25
Conversation
README.md
Outdated
## Dataset quality test | ||
:construction: how we plan to ensure the quality of the released dataset :construction: | ||
:construction: how we plan to ensure the quality of the released dataset. Contributions welcomed in issue #4 :construction: |
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.
Add a link to #4, maybe.
README.md
Outdated
|
||
## Use cases | ||
`./target/release/cosmogony -i /path/to/your/file.osm.pbf --libpostal /path/to/libpostal/rules/folder/ -o /path/for/output/file` |
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.
it's better to use cargo run --release
cargo run --release -- -i /path/to/your/file.osm.pbf --libpostal /path/to/libpostal/rules/folder/ -o /path/for/output/file
README.md
Outdated
## Use cases | ||
`./target/release/cosmogony -i /path/to/your/file.osm.pbf --libpostal /path/to/libpostal/rules/folder/ -o /path/for/output/file` | ||
|
||
Check out cosmogony help for more options: `./target/release/cosmogony -h` |
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.
same here
README.md
Outdated
|
||
We do not forbid ourself however to use other data sources (with compliant license), but we don't want `cosmogony` to be too complex and we do not aim to recreate the great [WhosOnFirst](https://www.whosonfirst.org/) ([see below](#See-also)) | ||
#### Build |
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.
I think you should add a note telling the update the submodules
update the git submodules:
`git submodule update --init`
README.md
Outdated
* GEOS (`apt-get install libgeos-dev`) | ||
|
||
Then, build cosmogony: `cargo build --release` | ||
|
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.
I would put a Use
subsection
README.md
Outdated
* rust (`curl https://sh.rustup.rs -sSf | sh`) | ||
* GEOS (`apt-get install libgeos-dev`) | ||
|
||
Then, build cosmogony: `cargo build --release` |
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.
maybe add a section on the unit tests ?
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.
you don't actually need to run the tests if you just want to use cosmogony. This may be in a contribute
section, what do you think ?
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.
yes a contribute section is nice
No description provided.