updated README for descriptors option for libraries.json files.

Jolanrensen · Jolanrensen · commit a3a7fedae77d · 2025-08-28T14:49:47.000+02:00
diff --git a/docs/libraries.md b/docs/libraries.md
@@ -933,13 +933,20 @@ resources. This file should contain FQNs of all integration classes in the JSON
         {
             "fqn": "org.jetbrains.kotlinx.jupyter.example.GettingStartedIntegration"
         }
-    ]
+    ],
+    "descriptors": []
 }
 ```
 
 Classes derived from the `LibraryDefinition` interface should be added to the `definitions` array.
 Classes derived from the `LibraryDefinitionProducer` interface should be added to the `producers` array.
 
+Additionally, you're allowed to add full custom library descriptors to the `descriptors` array.
+This is an advanced option that allows you to load additional dependencies or add additional imports using the
+[library descriptor API](#creating-a-library-descriptor).
+This can be particularly useful for libraries that cannot depend on the jupyter-api artifact but still want to modify
+the kernel behavior when loaded.
+
 For more information, see:
 
 * [Libraries repository](https://github.com/Kotlin/kotlin-jupyter-libraries)

Original file line number	Diff line number	Diff line change
`@@ -933,13 +933,20 @@ resources. This file should contain FQNs of all integration classes in the JSON`
`933`	`933`	`{`
`934`	`934`	`"fqn": "org.jetbrains.kotlinx.jupyter.example.GettingStartedIntegration"`
`935`	`935`	`}`
`936`		`- ]`
	`936`	`+ ],`
	`937`	`+ "descriptors": []`
`937`	`938`	`}`
`938`	`939`	```
`939`	`940`
`940`	`941`	Classes derived from the `LibraryDefinition` interface should be added to the `definitions` array.
`941`	`942`	Classes derived from the `LibraryDefinitionProducer` interface should be added to the `producers` array.
`942`	`943`
	`944`	+Additionally, you're allowed to add full custom library descriptors to the `descriptors` array.
	`945`	`+This is an advanced option that allows you to load additional dependencies or add additional imports using the`
	`946`	`+[library descriptor API](#creating-a-library-descriptor).`
	`947`	`+This can be particularly useful for libraries that cannot depend on the jupyter-api artifact but still want to modify`
	`948`	`+the kernel behavior when loaded.`
	`949`	`+`
`943`	`950`	`For more information, see:`
`944`	`951`
`945`	`952`	`* [Libraries repository](https://github.com/Kotlin/kotlin-jupyter-libraries)`