OpenLiberty / OpenLiberty/docs

Document application class loading search order for common libraries

Open
#7,944 0 comments 0 reactions 1 assignee View on GitHub

@dazavala is already working on this.

Since Jun 6, 2025.

24.0.0.8
Dominant language
No language data
Stars
14
Forks
58
Avg merge
4m
Merged PRs (30d)
35

Description

For design issue: https://github.ibm.com/websphere/WS-CD-Open/issues/34217

Update topic https://openliberty.io/docs/latest/class-loader-library-config.html#_configure_global_libraries to mention the content of common libraries is searched in the order in which libraries appear in the the application class loader's commonLibraryRefs configuration.

The update enables users to understand this seemingly internal server behavior is both reliable and supported.

todo: define actual content change

Template questions
Q: What do 80% of target users need to know to be most easily productive using your runtime update?

There is no corresponding runtime update. That said, target users must understand their application's dependencies on common library content in order to prescribe the order in which these libraries are searched.

Q: Which release will the runtime updates target? The Open Liberty docs team will aim to get the docs updates published in sync with the runtime updates.

N/A: There is no corresponding runtime update.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.