Update "libs" reference page to reflect modern use of term
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 35/100
- Issue type
- Documentation
- Clarity
- Needs clarification
- Activity status
- Stale
- Tech stack
- clojure
- Domain
- documentation
Research direction
Read the current https://clojure.org/reference/libs and https://clojure.org/reference/namespaces pages first, then compare how each uses “lib” and “namespace.” Done means the relationship and modern terminology are clarified without leaving confusing or duplicated guidance; the issue does not choose between updating or merging, so that decision needs maintainer input.
Written by the indexing model from the issue text.
Description
The https://clojure.org/reference/libs page is an old page and has a lot of useful information on it, but uses "lib" as a term to mean a Clojure namespace, which matches many 1.0-era docstrings. However, in modern use, "lib" is more commonly used to refer to a whole library, made up of many Clojure namespaces. This disconnect is confusing and/or jarring depending on your experience level with Clojure.
Should we update this page to clarify, merge with the https://clojure.org/reference/namespaces page, or something else?
- Dominant language
- HTML
- Stars
- 259
- Forks
- 275
- PR merge metrics
- No merged PRs in 30d
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from clojure/clojure-site
-
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
clojure/clojure-site#723 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
clojure/clojure-site#538 · 3 comments ·
-
help wanted
Difficulty 1/5 Under an hour Newbie friendliness 62/100
clojure/clojure-site#386 · 1 comment ·
-
Difficulty 1/5 Under an hour Newbie friendliness 55/100
clojure/clojure-site#715 ·
-
Difficulty 5/5 Over a week Newbie friendliness 25/100
clojure/clojure-site#713 ·
All issues in clojure/clojure-site
Similar issues
-
Link Checker Report Openautomated issue report
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
-
Humanity AI Open
Difficulty 1/5 Under an hour Newbie friendliness 90/100
numfocus/project-fundraising#166 ·
-
area:proxy bug security severity:low track:open-source
Difficulty 2/5 1-3 hours Newbie friendliness 70/100