# Sobre nosso SDK

![Arte por TsuneoMP](/files/JH6vLV6tZT1CvqnnhUa8)

O **Cordel Sideral** é um projeto de ficção *open source*. Qualquer pessoa pode contribuir com a expansão do nosso universo ou criar suas próprias histórias, ilustrações, vídeos e outros tipos de conteúdos inspirados por ele.

Isso é possível porque disponibilizamos a documentação do nosso universo ficcional sob a licença [Creative Commons CC BY-NC-SA 4.0](/primeiros-passos/termos-de-uso.md). Essa licença permite o livre compartilhamento e adaptação do material, mesmo para fins comerciais.

A documentação do Cordel leva o nome de **SDK** (*Story Development Kit*, ou "Kit de Desenvolvimento de Histórias"), uma adaptação da sigla idêntica usada no desenvolvimento de softwares, que, naquele caso, significa *Software Development Kit*, ou "Kit de Desenvolvimento de Software".

A melhor forma de se entender o que é o SDK é pensar nele como uma enciclopédia ou um manual para o universo ficcional do Cordel Sideral, onde você encontra descrições detalhadas dos principais elementos que o compõem.

{% hint style="info" %}
O SDK oficial do Cordel Sideral é frequentemente atualizado e disponibilizado exclusivamente no site <https://sdk.cordelsideral.com>.
{% endhint %}

## O que está incluído no SDK?

Os seguintes materiais são incluídos na distribuição oficial do SDK do Cordel Sideral e descritos em detalhes na forma de textos:

| Material                  | Descrição                                                                                                |
| ------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Acontecimentos**        | Acontecimentos históricos.                                                                               |
| **Biologia**              | Fauna, flora e espécies dos planetas habitados.                                                          |
| **Grupos e Organizações** | Grupos e demais organizações.                                                                            |
| **Idiomas**               | Idiomas falados pelos habitantes de diferentes planetas.                                                 |
| **Localidades**           | Planetas, cidades e outras localidades.                                                                  |
| **Magia**                 | Descrição de poderes mágicos e seu uso.                                                                  |
| **Personagens**           | Biografias de personagens.                                                                               |
| **Sociedade**             | Organização social no espaço habitado, incluindo sub-seções como Política, Economia, Religião, e outras. |
| **Tecnologia**            | Tecnologia em uso no espaço habitado.                                                                    |
| **Textos de importância** | Textos criados por personagens ficcionais do universo habitado, como poesias, artigos e notícias.        |

## Com que frequência o SDK é atualizado?

O material é frequentemente atualizado com novas adições e correções. Todas as atualizações são versionadas, significando que:

* Cada grande atualização, chamada de *release*, possui um nome próprio e um número único, como 1.0, 2.0, 3.0, etc;
* Alterações menores são lançadas dentro de um mesmo release e podem ser numeradas de diferentes formas, dependendo da sua complexidade. Ex: 1.1, 2.3, 2.1.2, etc;

Saiba mais sobre as versões já lançadas do nosso SDK acessando a página abaixo:

{% content-ref url="/pages/-MfnVid-AFyz-dA0m9oL" %}
[Roadmap](/story-development-kit/changelog.md)
{% endcontent-ref %}

As atualizações do SDK são planejadas com antecedência e, em geral, estão ligadas ao lançamento de novas histórias ou outros conteúdos do Cordel Sideral. Entretanto, atualizações desconectadas das histórias também podem ocorrer.

Você pode acessar o nosso roadmap, que mostra o planejamento de futuras atualizações, clicando [neste link](/story-development-kit/changelog.md).

## Como utilizo o material do SDK?

Se deseja saber mais sobre como colaborar com a expansão do nosso universo, acesse a página abaixo:

{% content-ref url="/pages/-MfmrgWnld1duZJTxHFc" %}
[Contribuindo com o SDK](/primeiros-passos/contribuindo-com-o-sdk.md)
{% endcontent-ref %}

Se deseja saber mais sobre como utilizar o SDK em suas próprias criações, acesse a página abaixo:

{% content-ref url="/pages/-MfmrkyWpCza07FQBRml" %}
[Utilizando o SDK](/primeiros-passos/utilizando-o-sdk.md)
{% endcontent-ref %}

## Por que o nome "SDK"?

Como o Cordel Sideral é um projeto de ficção científica, não conseguimos perder a oportunidade de nomear a documentação do nosso universo de "SDK", *Story Development Kit*.

A sigla é muito presente no desenvolvimento de software, contexto em que um SDK (*Software Development Kit*), desempenha o mesmo papel que a nossa documentação.

Além disso, somos fãs de trocadilhos e piadas do tipo e não conseguimos resistir à tentação :sweat\_smile:

## Permissões de uso

Saiba o que você pode e não pode fazer com o SDK acessando a página abaixo:

{% content-ref url="/pages/-MfnJbMtO\_gqOfnFVlYO" %}
[Termos de Uso](/primeiros-passos/termos-de-uso.md)
{% endcontent-ref %}


---

# 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://sdk.cordelsideral.com/primeiros-passos/sobre-nosso-sdk.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.