Skip to content

Expand README: overview, data sources, licence, layout and build notes - #13

Open
chrisdebian wants to merge 1 commit into
quantenschaum:masterfrom
chrisdebian:docs/readme-overview
Open

chrisdebian wants to merge 1 commit into
quantenschaum:masterfrom
chrisdebian:docs/readme-overview

Conversation

@chrisdebian

Copy link
Copy Markdown

Following up on #12, here's a first go at the README.

It keeps your existing intro and image, and adds:

  • a "not for navigation" note linking to the disclaimer and legal notice
  • what the project produces, and for which apps
  • data sources, with a pointer to the BSH data restrictions
  • the licence split (code GPL-3.0, charts CC0)
  • a short map of the folders
  • the tools the makefiles use and the main make targets

I also changed the documentation link from http to https.

Everything is taken from the makefiles, docs and folder contents, but please correct anything I've got wrong, especially the folder descriptions. Since make help prints the README, I kept it readable as plain text too.

I checked that every link works and that make help reads cleanly. I didn't run a full build, since a README change doesn't touch it.

As mentioned in #12, I used an AI assistant (Claude) to help read the code and draft this, and I've checked the content myself.

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.

1 participant