# Readme file

### Description

The `readme` file refers to a text file that provides information about the architecture, its features, requirements, installation instructions, and usage instructions.

{% hint style="info" %}
It's an important component as it serves as the first point of reference for users.
{% endhint %}

To add a README file to your architecture, click on the file icon placed at the end of the design area options bar:

![Read me](/files/ql2BSp5cNhgLtlENX0tB)

### Edit README file

To add information and edit the README file, just open the editor and add the details.

Brainboard gives you the possibility to write Markdown document and generates the HTML representation for it, which makes it super easier to read for you and your team.

![Read me configuration](/files/ekKPFmxxU7Ho9P4UPgGl)

### Visibility of the README file

* The README file will be displayed on the templates catalog
* The README file will be pushed to git when doing a pull request.
* The README file will be cloned along with the design of your architecture.

### Best practice

A good README file typically includes the following information:

* Project description: A brief overview of the architecture, its purpose, and its key features.
* Usage instructions: A step-by-step guide on how to use the architecture, including any variables and configuration settings.
* Support and contact information: Details on how to get support or contact the development team, such as through email, forums, or social media.
* Release notes: A list of changes, bug fixes, and new features for each release of the architecture.


---

# 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.brainboard.co/data/data-structure/cloud-architecture/readme-file.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.