> For the complete documentation index, see [llms.txt](https://docs.kyso.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kyso.io/search-and-discovery/browsing-files-and-versions.md).

# Browsing Files & Versions

## File Browsing

Readers can browse through the different files attached to the report.

Note that, by default, all files within a repository (folder) are imported into Kyso. To ensure certain files are not included in the import (example: images, data files, etc.) add a **`.kysoignore`** file to the directory and Kyso will not import those files.

You can have as many files, notebooks, etc.. within a project as you like.

<figure><img src="/files/tydDHbVogdVOjfJOa2F3" alt=""><figcaption><p>Browsing Files, Versions</p></figcaption></figure>

## Versions

For all reports published to Kyso, any new commits made will be reflected here. Kyso shows the latest version of a report by default, such that:

* All changes are tracked and maintained.
* Users can view previous versions of the report.

So this means that *analyses/research is always up to date and the project's lifecycle is maintained.*

{% hint style="info" %}
The main file on a report can change when a new version is pushed, if that is preferred. Imagine a data science project workflow, whereby a user documents their thoughts, requirements, etc. in Kyso's markdown editor.&#x20;

Later, they can clone the report from Kyso, move to the next stage of the project - e.g. modelling data in a Jupyter notebook. They can push the report back upstream to Kyso, now making the notebook the report's main file on this new version.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.kyso.io/search-and-discovery/browsing-files-and-versions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
