rzk-lang / sHoTT

Formalisations for simplicial HoTT and synthetic ∞-categories.
https://rzk-lang.github.io/sHoTT/
46 stars 12 forks source link

Update naming in 08-families-of-maps #117

Closed TashiWalde closed 1 year ago

TashiWalde commented 1 year ago

Many terms in 08-families-of-maps.rzk.md seem to be named using an outdated naming scheme.

For example the name total-equiv-family-of-equiv is written "conclusion-last" and is used for what I believe should be called is-fiberwise-equiv-is-total-equiv or is-family-of-equiv-is-equiv-total-map or some variation thereof.

Some names follow the "conclusion-first" paradigm, but mix up equiv and is-equiv. For example family-equiv-total-equiv takes a family of maps and an is-equiv (total-map), but returns not fiberwise is-equiv, but rather actual fiberwise equivalences Equiv. It should probably be called something like family-equiv-is-equiv-total-map.

I was a bit scared to just run off on my own and try to clean up the document, since a) it is long and b) probably many other things rely on it.

So what is the best policy for this? As a preliminary measure, one could add properly named synonyms for the most important "outward facing" terms so that at least the dirt is contained until one can do a proper project-wide cleaning.