# Feedback wanted: docs for -library instruction (add examples)

**URL:** <https://bnd.discourse.group/t/feedback-wanted-docs-for-library-instruction-add-examples/498>\
**Category:** GENERAL\
**Created:** [February 20, 2025, 10:58am UTC](https://bnd.discourse.group/t/feedback-wanted-docs-for-library-instruction-add-examples/498 "2025-02-20T10:58:31Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![chrisrueger](https://yyz2.discourse-cdn.com/free1/user_avatar/bnd.discourse.group/chrisrueger/32/18_2.png) [@chrisrueger](https://bnd.discourse.group/u/chrisrueger)\
**Post date:** [February 20, 2025, 10:58am UTC](https://bnd.discourse.group/t/feedback-wanted-docs-for-library-instruction-add-examples/498/1 "2025-02-20T10:58:31Z")

</div>

Hi,  
I tried to improve the docs around the [-library](https://bnd.bndtools.org/instructions/library.html) instruction, by adding some examples.

See

> <https://github.com/bndtools/bnd/pull/6479/files>
>
> Here is a suggested for improving the -library instruction. I have heard it bein…g mentioned a couple of times. But I think the current documentation is missing some examples to illustrate the usefulness (as in "what can I do with it, and when would I use it"?)
> 
> Here is what I did:
> 
> 1. added a introductory sentence
> 2. added examples
> 3. moved one section "Creating libraries" from the bottom higher up. To me that improves the reading flow and now is basically: 
> \- What is it
> \- examples
> \- how to create
> \- how to use

Would be nice to get some feedback if that makes sense or not.

Thanks

---

<div class="post-metadata">

**Author:** ![chrisrueger](https://yyz2.discourse-cdn.com/free1/user_avatar/bnd.discourse.group/chrisrueger/32/18_2.png) [@chrisrueger](https://bnd.discourse.group/u/chrisrueger)\
**Post date:** [February 24, 2025, 12:08pm UTC](https://bnd.discourse.group/t/feedback-wanted-docs-for-library-instruction-add-examples/498/2 "2025-02-24T12:08:59Z")

</div>

The docs have been updated:

> **[\-library library ( ‘,’ library )\*](https://bnd.bndtools.org/instructions/library.html)**
>
> The main reason for the -library instruction is to let you package and share bnd-related configuration in a self-contained way so it can be reused across workspaces, projects, or run descriptions.