From 9871fae92ba286b5546afc8fd33a063230fa9677 Mon Sep 17 00:00:00 2001 From: Manfred Moser Date: Thu, 3 Jul 2025 15:54:05 -0700 Subject: [PATCH 1/2] Add docs for Chainguard Libraries on console Signed-off-by : Manfred Moser --- content/chainguard/libraries/browse.md | 124 +++++++++++++++++++++++++ 1 file changed, 124 insertions(+) create mode 100644 content/chainguard/libraries/browse.md diff --git a/content/chainguard/libraries/browse.md b/content/chainguard/libraries/browse.md new file mode 100644 index 0000000000..c7bffda2e7 --- /dev/null +++ b/content/chainguard/libraries/browse.md @@ -0,0 +1,124 @@ +--- +title: "Browsing Chainguard Libraries" +linktitle: "Browsing" +description: "Searching, browsing, and inspecting Chainguard Libraries in the console" +type: "article" +date: 2025-07-03T14:00:00+00:00 +lastmod: 2025-07-03T14:00:00+00:00 +draft: false +tags: ["Chainguard Libraries"] +menu: + docs: + parent: "libraries" +weight: 007 +toc: true +--- + +Chainguard Libraries includes thousands of libraries and many more individual +library versions and artifacts. The Chainguard console includes features to +browse all available libraries and their versions, and inspect some of their +characteristics, before using them in your application development. + +## Access + +Use your authentication details to access the console at +[https://console.chainguard.dev/](https://console.chainguard.dev/). + +The left-hand navigation includes a **Libraries** section. Nested within the +**Ecosystems** drop-down you find links to browse the libraries from Chainguard +Libraries for **Java** and Chainguard Libraries for **Python**. + + + +## Initial Display + +The initial display when accessing a specific ecosystem shows a search input box +and a list of libraries with the following columns. + +* **Name** - the full name of the library excluding any version identifiers. + Python library names are a simple string, such as `setuptools` or + `Flask-Admin`. Java library names are the concatenation of the Maven + coordinate values `groupId` and `artifactId`, separated by `:`. Examples are + `org.springframework:spring-core` or `org.eclipse.jetty:jetty-http`. +* **Latest version** - the latest released and available version of the library + and the total number of available versions. +* **Created** - TBD .. not sure what specific date that is, arguably it should + be removed because it is not clear what library version these values are for, + or header tile should change to Latest version release date or something + (upstream release date ...), when Chainguard built a library could be a + separate field but that might be less useful, +* **Updated** - TBD .. not sure .... I think we should remove this, libraries + should not change so there should be no updated date + +Below the list is a pagination control with **Previous** and **Next** buttons +and a total count of available libraries. + +Clicking on a row brings you to the [specific library page](#library-page). + + + +## Search + +Use the **Search** text input on the [initial display](#initial-display) to +narrow down the list of displayed libraries and locate a specific library. + +TBD Say more about what search patterns are supported and such, this is currently changing +Currently works partial match on name (art) + +TBD - feature-wise Needs some sort of progress display since its sometimes slow + +Search results display identically to the [initial display](#initial-display) +but with a limited number of libraries. + +Clicking on a row brings you to the [specific library page](#library-page). + + + +## Library Page + +Access the library page by clicking on the row for a specific library in the +search results or the initial display page. + +The title of the library page shows the name of the library and includes a text +input to filter the displayed library versions. + +The list of library versions uses the following columns: + +* **Version** - the version of the library. Library versions are strings. + Depending on the ecosystem and library they can follow naming patterns and + other restrictions that allow ordering by version. +* **Size** - TBD .. size of what? the jar , the pom, the war, probably should be + removed and used on the library version page that lists the files +* **Created** - TBD .. not sure what specific date that is, we should probably + change that to be the release date of the upstream release, when Chainguard + build a library could be a separate field but that might be less useful +* **Updated** - TBD .. not sure .... I think we should remove this, libraries + should not change so there should be no updated date + +Click on the column titles to change the **sort** order of the list. + +Clicking on a row brings you to the [specific library version +page](#library-version-page). + + + +## Library Version Page + +TBD - does not exist yet Shows details about the library including list of +available files and ideally also some of the metadata like source URL or Python +specifics like supported glibc versions, operating systems + +potentially add download feature for files + +## Java-specific Details ?? + +TBD ? + +jar file typically, also pom and others, probably also all the provenance and +signature files and such + +## Python-specific Details ?? + +TBD? + +wheel and sdist files, also for different operating systems and so on From a871ac6eb3debec67a34ced54d29ec798d163797 Mon Sep 17 00:00:00 2001 From: s-stumbo Date: Thu, 26 Feb 2026 16:30:41 -0500 Subject: [PATCH 2/2] updates Signed-off-by: s-stumbo --- content/chainguard/libraries/browse.md | 98 +++++++------------------- 1 file changed, 27 insertions(+), 71 deletions(-) diff --git a/content/chainguard/libraries/browse.md b/content/chainguard/libraries/browse.md index c7bffda2e7..2a0776f745 100644 --- a/content/chainguard/libraries/browse.md +++ b/content/chainguard/libraries/browse.md @@ -15,69 +15,55 @@ toc: true --- Chainguard Libraries includes thousands of libraries and many more individual -library versions and artifacts. The Chainguard console includes features to -browse all available libraries and their versions, and inspect some of their -characteristics, before using them in your application development. +library versions and artifacts. Through the Chainguard Console, you can +browse all available libraries and their versions, and inspect their +characteristics before using them in your application development. -## Access +## Access libraries in the Chainguard Console -Use your authentication details to access the console at +Log in to the Chainguard Console at [https://console.chainguard.dev/](https://console.chainguard.dev/). -The left-hand navigation includes a **Libraries** section. Nested within the -**Ecosystems** drop-down you find links to browse the libraries from Chainguard -Libraries for **Java** and Chainguard Libraries for **Python**. +In the left-hand navigation under **Libraries**, expand **Ecosystems** to find links for browsing Chainguard's [**Java**](/chainguard/libraries/java/overview/) and [**Python**](/chainguard/libraries/python/overview/) libraries. -## Initial Display +### Browse the libraries list -The initial display when accessing a specific ecosystem shows a search input box -and a list of libraries with the following columns. +When you open a specific ecosystem, you'll see a search input box +and a list of libraries. Click any row to open the [library detail page](#library-page). -* **Name** - the full name of the library excluding any version identifiers. - Python library names are a simple string, such as `setuptools` or - `Flask-Admin`. Java library names are the concatenation of the Maven +The list includes the following columns: + +* **Name** - the full library name, excluding any version identifiers. + * Python library names are simple strings, such as `setuptools` or + `Flask-Admin`. + * Java library names are the concatenation of the Maven coordinate values `groupId` and `artifactId`, separated by `:`. Examples are `org.springframework:spring-core` or `org.eclipse.jetty:jetty-http`. * **Latest version** - the latest released and available version of the library and the total number of available versions. -* **Created** - TBD .. not sure what specific date that is, arguably it should - be removed because it is not clear what library version these values are for, - or header tile should change to Latest version release date or something - (upstream release date ...), when Chainguard built a library could be a - separate field but that might be less useful, -* **Updated** - TBD .. not sure .... I think we should remove this, libraries - should not change so there should be no updated date - -Below the list is a pagination control with **Previous** and **Next** buttons -and a total count of available libraries. +* **Updated** - The most recent date when any version of this library was built and published by Chainguard. -Clicking on a row brings you to the [specific library page](#library-page). +At the bottom of the page, see a total count of available libraries. -## Search - -Use the **Search** text input on the [initial display](#initial-display) to -narrow down the list of displayed libraries and locate a specific library. - -TBD Say more about what search patterns are supported and such, this is currently changing -Currently works partial match on name (art) +### Search the libraries list -TBD - feature-wise Needs some sort of progress display since its sometimes slow +Use the **Search** text input at the top of the libraries list to +narrow down the list and to locate a specific library. -Search results display identically to the [initial display](#initial-display) -but with a limited number of libraries. - -Clicking on a row brings you to the [specific library page](#library-page). +Click into a row to view a [specific library page](#library-page). ## Library Page -Access the library page by clicking on the row for a specific library in the -search results or the initial display page. +To access a library page, click on the row for a specific library in the +search results or the initial library list. + +On a library's page, use the search bar at the top to search for specific versions. The title of the library page shows the name of the library and includes a text input to filter the displayed library versions. @@ -87,38 +73,8 @@ The list of library versions uses the following columns: * **Version** - the version of the library. Library versions are strings. Depending on the ecosystem and library they can follow naming patterns and other restrictions that allow ordering by version. -* **Size** - TBD .. size of what? the jar , the pom, the war, probably should be - removed and used on the library version page that lists the files -* **Created** - TBD .. not sure what specific date that is, we should probably - change that to be the release date of the upstream release, when Chainguard - build a library could be a separate field but that might be less useful -* **Updated** - TBD .. not sure .... I think we should remove this, libraries - should not change so there should be no updated date +* **Size** - the size of the library. +* **Built** - The date when this version was built and published by Chainguard. Click on the column titles to change the **sort** order of the list. -Clicking on a row brings you to the [specific library version -page](#library-version-page). - - - -## Library Version Page - -TBD - does not exist yet Shows details about the library including list of -available files and ideally also some of the metadata like source URL or Python -specifics like supported glibc versions, operating systems - -potentially add download feature for files - -## Java-specific Details ?? - -TBD ? - -jar file typically, also pom and others, probably also all the provenance and -signature files and such - -## Python-specific Details ?? - -TBD? - -wheel and sdist files, also for different operating systems and so on