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

update readme #25

Merged
merged 2 commits into from
Feb 8, 2018
Merged

update readme #25

merged 2 commits into from
Feb 8, 2018

Conversation

nlehuby
Copy link
Contributor

@nlehuby nlehuby commented Feb 7, 2018

No description provided.

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

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`
Copy link
Contributor

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`
Copy link
Contributor

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
Copy link
Contributor

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`

Copy link
Contributor

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`
Copy link
Contributor

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 ?

Copy link
Contributor Author

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 ?

Copy link
Contributor

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

@antoine-de antoine-de merged commit ecd1ca4 into master Feb 8, 2018
@nlehuby nlehuby deleted the readme branch February 26, 2018 09:44
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.

3 participants