For 1.0 I would like to see all major packages adhere to the Guidelines for Naming Packages , especially spelling out acronyms in package names unless they’re completely obvious and unambigous. E.g. SVD would be ok as a package name, but GMT should be converted to GenericMappingTools. This isn’t syn…

I did consult those guidelines but GMT is not an acronym created for the Julia package. GMT is the original name of a venerable but quite actively maintained project of ~30 years age.

Agreed that Julia packages should adhere to the naming scheme, but GMT seems fine to me in this case.

Each to their own abbreviation/acronym…

[image] List of most desired features for Julia v1.x SVD would be ok as a package name I have no idea what SVD means

That’s why I have always advocated for 0 abbreviations in package names. One person’s obvious “used-every-minute-in-my-field” acronym is the next person’s mystery.

[image] List of most desired features for Julia v1.x That’s why I have always advocated for 0 abbreviations in package names. One person’s obvious “used-every-minute-in-my-field” acronym is the next person’s mystery. In that case, does it matter if it’s an acronym? If you’re not in that indust…

The Guidelines for Naming Packages (link above) begins “Package names should be sensible to most Julia users, even to those who are not domain experts.” I can think of four acronyms that might qualify as sensible to most Julia users: ODE, PDE, SVD, and FFT. But I’d be happy to give those up and agre…

Fun fact: “ODE”, “SVD” and “FFT” are all terms that I’ve googled after starting to use Julia (“SVD” yesterday). I still don’t know what “PDE” means (but I’ll probably google it later :joy: )

@mkborregaard : I guess I ought to think of Julia users as broader than just applied math! I’ll come down on the side of 0 abbreviations, then.

There is still the cognitive burden of “Do I know what this is or not?” If I see SVD, it could be any number of acronyms in my head. If I were to SingularValueDecomposition, I know immediately that it has no relevance to my work. Granted SingularValueDecomposition is a bit of a mouthful.

Package naming guidelines

Community

mkborregaard November 15, 2017, 10:00pm 5

I have no idea what SVD means

6 Likes

Topic		Replies	Views
Naming: Remove all underscores to matter what? General Usage	123	7839	January 28, 2018
The present and the future of package registration Package Management	80	2567	June 11, 2023
How can we create a leaner ecosystem for Julia? Statistics package , proposal , time-series , machine-learning	101	10845	October 15, 2020
"Names" packages? Tooling	31	2073	April 13, 2021
Explicit package names Community	11	895	June 12, 2021

Package naming guidelines

Related topics