Skip to content

fix/chore: update documentation of the file format#7

Merged
fpvandoorn merged 1 commit into1000-plus:mainfrom
grunweg:MR-fix-readme
Dec 16, 2024
Merged

fix/chore: update documentation of the file format#7
fpvandoorn merged 1 commit into1000-plus:mainfrom
grunweg:MR-fix-readme

Conversation

@grunweg
Copy link
Copy Markdown
Contributor

@grunweg grunweg commented Dec 1, 2024

Having a specification of the file format is great and really helpful!
The current version is sometimes imprecise, sometimes incomplete
(e.g. dangling sentences) and sometimes outdated. Correct all three.

In addition, remove (any implicit mention of) the 'identifiers' field from
the README: these are more unstable; we prefer to track stable URLs
(which point to the respective theorems) rather than identifiers which become
outdated more quickly.

Found while implementing a more typed parser for this, for use in synchronising
this database with a file of formalisations in mathlib.

README.md Outdated
- "S": standard library
- "L": main (biggest) mathematical library (afp, hol light outside standard library, mathcomp, mathlib, mml, set.mm)
- "X": external to the main or standard library (e.g. a dedicated repository)
* `identifiers`: list of theorems for a particular proof assistant; strongly recommended for "S" or "L" formalizations
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Do we want to track the identifier in this repository? I would prefer to have less information here, so that it doesn't have to be updated frequently.

Otherwise LGTM

Copy link
Copy Markdown
Contributor Author

@grunweg grunweg Dec 16, 2024

Choose a reason for hiding this comment

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

Updated now. Merging #6 first makes more sense logically.

grunweg added a commit to grunweg/1000-plus.github.io that referenced this pull request Dec 16, 2024
- the entry for the Stone-Weierstrass theorem was outdated; update the URL
- remove the 'identifiers' field from this and the continuum hypothesis entry
(which are the only occurrences of these fields): in 1000-plus#7, the identifiers
fields will be removed from the README.
@grunweg
Copy link
Copy Markdown
Contributor Author

grunweg commented Dec 16, 2024

Depends on #6, and a rebase. Ping me once the former PR is in, then I can do the latter.

Having a specification of the file format is great and really helpful!
The current version is sometimes imprecise, sometimes incomplete
(e.g. dangling sentences) and sometimes outdated. Correct all three.

In addition, remove (any implicit mention of) the 'identifiers' field from
the README: these are more unstable; we prefer to track stable URLs
(which point to the respective theorems) rather than identifiers which become
outdated more quickly.

Found while implementing a more typed parser for this, for use in synchronising
this database with a file of formalisations in mathlib.
@grunweg
Copy link
Copy Markdown
Contributor Author

grunweg commented Dec 16, 2024

Rebased: from my side, this is ready to be merged.

@fpvandoorn fpvandoorn merged commit cc9b735 into 1000-plus:main Dec 16, 2024
@grunweg grunweg deleted the MR-fix-readme branch December 16, 2024 13:09
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