|
|
|
|
|
by compressedgas
1917 days ago
|
|
To me a good README needs to: - tell what the software does - list its requirements - explain how to set it up It must do this only relying on local files. The README of AGE meets some of these. The description could better. I'd open with: Apache AGE is an PostgreSQL extension that implements the openCypher property graph query language. I would remove the latest happenings from the README and keep them on the project home page which I would have a link to right after the description. I would also I would include the source of Apache_AGE_Guide.pdf in the repository. It is fine to have a link to the already formatted PDF should some one be viewing the README on a device where building the software isn't possible. But I would not want a user to download a snapshot or the repository and then discover that they have to have further internet access to get the documentation. |
|