Motivation is simple: it's tough to distinguish between what goes into @stdlib/... libraries and what's generally available without importing. At the moment, stdlib/std/ holds what's available right away and stdlib/libs/ holds @stdlib/... libraries.
We may change it in the following manner:
stdlib/std → stdlib/core , to match the notion of "Core library" in the docs.
stdlib/libs may stay as is, or be expanded to stdlib/libraries or even renamed to stdlib/standard
stdlib/stdlib.tact may stay as is, or be renamed to stdlib/core.tact to match their contents
Additionally, it can be useful to describe things in stdlib/ on the top-level somewhere in a README.md or a standalone ARCHITECTURE.md or CONTRIBUTING.md guide:
stdlib, Standard library:
|-- libraries/ or standard/ —
Libraries one can import through `@stdlib/...`, "standard libraries"
|-- core/ — Auto-imported code, "core library"
|-- stdlib.fc — Standard library of FunC
|-- stdlib_ex.fc — Extension of standard library of FunC
`-- stdlib.tact or core.tact — Batch export of core/
Perhaps, even the folder itself can be renamed from stdlib to just std, which will simplify things furthermore:
std/libraries — standard libraries
std/core — core library or core of the standard library
Motivation is simple: it's tough to distinguish between what goes into
@stdlib/...libraries and what's generally available without importing. At the moment,stdlib/std/holds what's available right away andstdlib/libs/holds@stdlib/...libraries.We may change it in the following manner:
stdlib/std→stdlib/core, to match the notion of "Core library" in the docs.stdlib/libsmay stay as is, or be expanded tostdlib/librariesor even renamed tostdlib/standardstdlib/stdlib.tactmay stay as is, or be renamed tostdlib/core.tactto match their contentsAdditionally, it can be useful to describe things in
stdlib/on the top-level somewhere in aREADME.mdor a standaloneARCHITECTURE.mdorCONTRIBUTING.mdguide:Perhaps, even the folder itself can be renamed from
stdlibto juststd, which will simplify things furthermore:std/libraries— standard librariesstd/core— core library or core of the standard librarystd/*.fc— FunC stuffstd/core.tact— batch export of core/