# Welcome

Welcome to the Yet Another Mechanism System (YAMS) documentation! 

<figure><img src="/files/R3nYZtBjF4OplL5ULUdx" alt=""><figcaption></figcaption></figure>

YAMS is a very easy and seamless library that fuses simulation and real control as closely as possible to real life so you can debug and program your robot without the actual robot! This can enable you to program your robot before its even built too!

{% hint style="danger" %}
Mechanism classes are meant to be used with "tightly coupled" mechanisms where the Mechanism has 1 or more motor controlling it on a connected shaft, gearbox, or other linkage.&#x20;

**IF** your mechanism is "loosely coupled", you **CAN** still use YAMS. **HOWEVER** you have to create and control the `SmartMotorController` directly as shown in [How do I control a Mechanism without a Mechanism Class?](/yams/documentation/how-to/how-do-i-control-a-mechanism-without-a-mechanism-class.md)
{% endhint %}

### Jump right in

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden></th></tr></thead><tbody><tr><td><h4><i class="fa-bolt">:bolt:</i></h4></td><td><strong>Create an  Arm!</strong></td><td>Create your first Arm!</td><td><a href="/pages/ppE3TCrQO1xJacC1pgJ2">/pages/ppE3TCrQO1xJacC1pgJ2</a></td><td></td><td></td></tr><tr><td><h4><i class="fa-leaf">:leaf:</i></h4></td><td><strong>Create an Elevator!</strong></td><td>Create your first elevator!</td><td><a href="/pages/RhJlo1xUTVtZdtHe1vXT">/pages/RhJlo1xUTVtZdtHe1vXT</a></td><td></td><td></td></tr><tr><td><i class="fa-crosshairs">:crosshairs:</i></td><td><strong>Create a shooter!</strong></td><td>Create your first shooter!</td><td><a href="/pages/ci1fSsNzdujaO8nvitiC">/pages/ci1fSsNzdujaO8nvitiC</a></td><td></td><td></td></tr></tbody></table>


---

# 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://yagsl.gitbook.io/yams/documentation/readme.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.