# Turbo Go — documentation

Turbo Go is a Turbo C-style editor for Go: a full-screen terminal IDE with menus, movable windows, syntax colouring for nine languages, themes, completion from `gopls`, shell windows, per-project settings, a project tree, snippets, and the go toolchain a menu away.

This documentation follows the [Diátaxis](https://diataxis.fr) method. Four kinds of page, four different needs — go to the one that matches what you want right now.

| I want to… | Go to |
| --- | --- |
| **learn** the editor by using it | [Tutorials](tutorials/) |
| **do** something specific | [How-to guides](how-to/) |
| **look up** an exact detail | [Reference](reference/) |
| **understand** how and why it works | [Explanation](explanation/) |

## Tutorials — learning by doing

- [Your first file in Turbo Go](tutorials/getting-started.md) — build, open the editor, type a Go program, colour it, save it and run it.

## How-to guides — recipes for a task

- [How to install and build Turbo Go](how-to/install.md)
- [How to run the tests](how-to/run-the-tests.md)
- [How to enable Go completion](how-to/enable-completion.md)
- [How to write your own theme](how-to/write-a-theme.md)
- [How to move around a file](how-to/navigate-code.md)
- [How to ask what the code means](how-to/ask-about-code.md)
- [How to run shell commands without leaving the editor](how-to/use-a-terminal.md)
- [How to give a project its own settings](how-to/configure-a-project.md)
- [How to browse a project and open files from a tree](how-to/browse-a-project.md)
- [How to insert snippets from a menu](how-to/use-snippets.md)
- [How to run go commands from the editor](how-to/run-go-commands.md)
- [How to talk to a coding agent from the editor](how-to/talk-to-an-agent.md)
- [How to make a release](how-to/make-a-release.md)

## Reference — the exact details

- [Command line](reference/cli.md)
- [Keyboard](reference/keyboard.md)
- [Menus](reference/menus.md)
- [Theme file format](reference/themes.md)
- [Terminal windows](reference/terminal.md)
- [Project settings](reference/project-settings.md)
- [Project tree](reference/project-tree.md)
- [Languages coloured](reference/languages.md)
- [Snippets](reference/snippets.md)
- [Go tools](reference/go-tools.md)
- [Agents and ACP](reference/acp.md)
- [The version number](reference/versioning.md)

## Explanation — understanding

- [Architecture](explanation/architecture.md)
- [Design decisions](explanation/design-decisions.md)
- [Colouring and completion](explanation/colouring-and-completion.md)
- [Terminal windows](explanation/terminal-windows.md)
- [Project settings](explanation/project-settings.md)
- [Project tree](explanation/project-tree.md)
- [Snippets](explanation/snippets.md)
- [Go tools](explanation/go-tools.md)
- [Agent windows](explanation/agent-windows.md)