Skip to content

Commit

Permalink
Update package naming guidelines to encourage consideration of the gl…
Browse files Browse the repository at this point in the history
…obal namespace (JuliaLang#53514)

Co-authored-by: Daniel Wennberg <daniel.wennberg@gmail.com>
Co-authored-by: Matt Bauman <mbauman@juliahub.com>
  • Loading branch information
3 people authored and tecosaur committed Mar 4, 2024
1 parent 969f81d commit ce9a32b
Showing 1 changed file with 13 additions and 0 deletions.
13 changes: 13 additions & 0 deletions doc/src/tutorials/creating-packages.md
Original file line number Diff line number Diff line change
Expand Up @@ -605,9 +605,22 @@ may fit your package better.

* `CPLEX.jl` wraps the `CPLEX` library, which can be identified easily in a web search.
* `MATLAB.jl` provides an interface to call the MATLAB engine from within Julia.

7. Avoid naming a package closely to an existing package
* `Websocket` is too close to `WebSockets` and can be confusing to users. Rather use a new name such as `SimpleWebsockets`.

8. Avoid using a distinctive name that is already in use in a well known, unrelated project.
* Don't use the names `Tkinter.jl`, `TkinterGUI.jl`, etc. for a package that is unrelated
to the popular `tkinter` python package, even if it provides bindings to Tcl/Tk.
A package name of `Tkinter.jl` would only be appropriate if the package used Python's
library to accomplish its work or was spearheaded by the same community of developers.
* It's okay to name a package `HTTP.jl` even though it is unrelated to the popular rust
crate `http` because in most usages the name "http" refers to the hypertext transfer
protocol, not to the `http` rust crate.
* It's okay to name a package `OpenSSL.jl` if it provides an interface to the OpenSSL
library, even without explicit affiliation with the creators of the OpenSSL (provided
there's no copyright or trademark infringement etc.)

## Registering packages

Once a package is ready it can be registered with the [General Registry](https://github.com/JuliaRegistries/General#registering-a-package-in-general) (see also the [FAQ](https://github.com/JuliaRegistries/General#faq)).
Expand Down

0 comments on commit ce9a32b

Please sign in to comment.