# 8.Description

{% code overflow="wrap" %}

```yaml
#Example ONLY
description: "A short summary about the pkg"
```

{% endcode %}

* [x] Short Summarized <mark style="color:orange;">**Description**</mark> about the <mark style="color:purple;">**`$pkg`**</mark> (**TYPE**:<mark style="color:red;">**`ENFORCED`**</mark>)
* [x] [**repology-fetcher** ](https://github.com/pkgforge/metadata/blob/main/soarpkgs/scripts/repology_fetcher.sh)can Autogenerate Multiple Description from [**Repology**](https://repology.org/projects/), Pick the Best one.
* [x] [**search.nixos.org**](https://search.nixos.org/packages) also has Saner Descriptions
* [x] Otherwise, Use abridged version from the <mark style="color:purple;">**`$pkg`**</mark>'s <mark style="color:orange;">**Homepage**</mark> etc

{% hint style="info" %}
For [<mark style="color:purple;">**SBUILD**</mark>](https://github.com/pkgforge/soarpkgs) that [**provides multiple progs**](/sbuild/specification/16.provides.md), you can have a per prog description:

{% code overflow="wrap" %}

```yaml
description:
  _default: "A simple description that would apply for the entire .pkg_family" #Applies to the whole pkg_family, overriden if seprate description for each prog exist (Like Below)
  progA: "A simple description only for progA" #Only Applies to progA
  progB: "Another description for progB" #Only Applies to progB
```

{% endcode %}
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pkgforge.dev/sbuild/specification/8.description.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.