docs(note_create): improve clarification of type system

This commit is contained in:
Jakob Schlanstedt 2025-10-22 15:47:31 +02:00 committed by Jakob Schlanstedt
parent b82d75674a
commit ee532eea45

View file

@ -14,7 +14,7 @@ import dateNoteService from "../services/date_notes.js";
/** /**
* Creating notes through note_create can have multiple kinds of valid * Creating notes through note_create can have multiple kinds of valid
* arguments. This type hierchary is checking if the arguments are correct. * arguments. This type hierarchy is checking if the arguments are correct.
* Later the functions of note_create are overloaded based to reflect these types, * Later the functions of note_create are overloaded based to reflect these types,
* which define valid arguments. * which define valid arguments.
* *
@ -22,9 +22,10 @@ import dateNoteService from "../services/date_notes.js";
* create a valid state, given that the types are defined correctly. * create a valid state, given that the types are defined correctly.
* Through the CurryHoward correspondence, this acts as a proof system * Through the CurryHoward correspondence, this acts as a proof system
* proving that the arguments will produce a correct state at compile time. * proving that the arguments will produce a correct state at compile time.
* that just means that if the code type-checks, then the provided options * That means when typescript does type-checks, then the arguments will
* represent a valid state. To represent the theoretical bases `type` is * definitely represent a valid state.
* used instead of `interface` *
* To represent the theoretical bases `type` is used instead of `interface`
* *
* * Hierarchy of general to specific categories(hypernyms -> hyponyms): * * Hierarchy of general to specific categories(hypernyms -> hyponyms):
* *