# Generic page example

{% hint style="info" %}
This page provides an example of the generic documentation page for **Topics** vocabulary.

Text within square brackets \[like this one] should be considered a comment for an author and should not be included into a final page.\
\
This note and other notes of this colour would be removed in the real page.
{% endhint %}

***

## Topics

{% hint style="info" %}

* Do not create the "Summary" heading
* Describe the capabilities of the feature this pages is about. This is to explain what it can do.
* Describe examples of how it can be helpful. This is to explain how it can be applied as some people need examples to understand the application of a feature.
  {% endhint %}

Topics are generally used to group information by topic or subject. Out-of-the-box, CivicTheme comes with several topics set up - you just need to edit them to the topics you'd like.

### Managing Topics

{% hint style="info" %}

1. Describe what role a user should have in order to use the feature.
2. Describe the steps to add or modify a feature: provide screenshots on how to choose the component
3. Do not provide descriptions of the fields that already have an obvious descriptions - these are superfluous and only repeat what is already provided in the UI without adding much value. Also, this adds to the maintenance cost.
4. Describe what can be done with one or multiple properties *from the point of use*:
   1. Provide a sub-heading
   2. Provide a screenshot of admin + a screenshot of the rendered component
5. For complex features, provide an "Example" sub-section with a full use-case description and screenshots.
   {% endhint %}

You should be logged in as a user with Site administrator role to modify topics.

1. Navigate to the Administration → Structure → Vocabularies → Topics
2. Click on “Add” or “Edit” term.
3. Provide Topic details
4. Click “Save” to save changes.

### Using Topics

Topics can be used within Automated list content component group information.

Below you can see an example of three News card showing three different topics - Scholarships, International students, and Research within an Automated list.

\[screenshot of the usage of the here]

See Automated list component page for more details.


---

# 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.civictheme.io/development/maintenance/authoring-documentation/generic-page-example.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.