-
Notifications
You must be signed in to change notification settings - Fork 4
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Decide on an implementation naming convention #11
Comments
if someone is looking for an implementation how do they go about searching for it? as a target use of the implementation, will i be making my selection driven by the algorithm or by the language i prefer? What am i searching for? We should optimize the naming convention for what intended users are going to search for. I don't have an answer one way or another. |
Looked at a few other projects with SDKs, primary naming is language first. |
I generally like the scheme. |
I have no data to back this up, but I can imagine the first criteria is capability - ie cryptography -> kem -> kyber (mlkem) as that's likely what I'm trying to add/change in my stack ? Language is often (not always) the next constraint. I have a primarily rust app, that's what I want to use. That being said I can imagine any of the other criteria - level of assurance, optimizations for performance, memory size, architecture are all really relevant too. Overall I like the scheme proposed. ensuring some key criteria are in the name, somewhere, helps with filtering repos (but we shouldn't have too long names?). Especially as we get further right in the name I think we can be less prescriptive as we're trying to condense a lot into a small space! We can also
|
Agreed, may be worth it for the TSC to define a set of tags, labels, or other needed descriptors to support engineers searching for the right library.
Similar to above, if we are consistent in the minimum content and placement of such content within a README it makes it simpler.
YES. This can be on a website or in the TSC repo proper. TSC can pull together a matrix for those libraries that conveys or pulls some of this from the repository so there is a single central point when someone is trying to understand what options are available to them, if they are in development, stable, prod ready, etc.
This may be some SEO work that can be passed to the PQCA staff to assist with. |
We have a virtual hack day coming up next Tuesday (12). I presume this will involve create new repos, so I suggest going with the original proposal on naming. This is prior to tsc kickoff, and there may be repo renames later if required. |
Closing as we adopted an initial naming scheme. No objects in 2024-06-20 TSC meeting |
One convention would be
For example:
mlkem-c-generic
mlkem-assembly-avx2-jasmin
mlkem-rust-libcrux
mlkem-c-stackoptimized
mlkem-c-aarch64
The text was updated successfully, but these errors were encountered: