deco-sites · ricardohenriquerh · Sep 18, 2025 · Sep 18, 2025
diff --git a/docs/pt/01_getting_started/01_creating_a_site.mdx b/docs/pt/01_getting_started/01_creating_a_site.mdx
@@ -1,7 +1,7 @@
 ---
 title: Criando um Site
 description: |
-   Passo a passo de como criar um site na Deco.cx.
+  Passo a passo de como criar um site na Deco.cx.
 ---
 
 Esta documentação vai te guiar pelo processo de criação e configuração do seu
@@ -17,25 +17,9 @@ a estrutura e componentes comuns a páginas de aterrissagem.
 
 ![Escolhendo um template](https://deco.cx/docs/getting-started/creating-site/choose-template.png)
 
-## 2. Explorar o Template
-
-Depois de selecionar um template, você pode explorar seus componentes em modo
-compartilhado de visualização apenas. Isso permite que você explore as
-configurações e recursos do template sem fazer nenhuma alteração.
-
-![Editar um site](https://deco.cx/docs/getting-started/creating-site/site-editor.png)
-
-## 3. Salvar Seu Site
+### 1.1. Faça login na plataforma
 
-Para criar oficialmente seu site a partir do template, clique no botão "Use this
-template" no canto superior direito da página de administração para reivindicar
-a propriedade do site.
-
-![Salvar site para sua equipe](https://deco.cx/docs/getting-started/creating-site/save-site-btn.png)
-
-### 3.1. Faça login na Plataforma
-
-### 3.2. Dê um Nome ao Seu Site e Escolha uma Equipe
+### 1.2. Dê um nome ao seu site e escolha uma equipe
 
 Você será solicitado a escolher um nome para o seu site e uma equipe para
 salvá-lo:
@@ -48,69 +32,43 @@ Se você ainda não tiver uma equipe, uma será criada com um nome à sua escolh
 
 A Deco vai configurar seu site de acordo com o template que você escolheu.
 
-## 4. Finalizar Configuração do Site
-
-Você será redirecionado para a página inicial do site:
-
-![Página Inicial do Site](https://deco.cx/docs/getting-started/creating-site/site-home.png)
-
-A partir daqui, você tem duas opções:
-
-1. Rodar seu site localmente usando seu ambiente de desenvolvimento local.
-   - Isso te dá o poder de modificar seu site alterando seu código, bem como
-     usando o Deco Admin.
-2. Criar um novo ambiente para editar seu site apenas através do Deco Admin.
-   - Aqui você pode fazer alterações no seu site sem precisar ter acesso ao
-     código do site.
-
-### Opção 1: Rodar Seu Site Localmente
-
-Para rodar seu site localmente, você precisa:
-
-1. Instalar o Deno na sua máquina. Você pode seguir as instruções no
-   [site do Deno](https://deno.land/).
-2. Clonar o repositório do site:
-   ```bash
-   git clone git@github.com:deco-sites/maria-landing.git
-   ```
-3. Entrar na pasta do repositório e iniciar o servidor:
-   ```bash
-   cd maria-landing
-   DECO_ENV_NAME=localhost deno task start
-   ```
-
-Agora, você pode modificar o código e ver as mudanças no Admin e vice-versa.
-
-### Opção 2: Criar um Novo Ambiente
+## 2. Explorar o Template
 
-Ambientes são espaços de trabalho isolados onde você pode fazer alterações no
-seu site sem afetar o site ao vivo. Para criar um novo ambiente:
+Depois de selecionar um template, você pode explorar seus componentes em modo
+compartilhado de visualização apenas. Isso permite que você explore as
+configurações e recursos do template sem fazer nenhuma alteração.
 
-1. Clique no botão "New" no dropdown de ambientes no Admin.
-   ![Botão Novo Ambiente](https://deco.cx/docs/getting-started/creating-site/new-env-btn.png)
-2. Escolha um nome e um host para o seu ambiente. Como não vamos rodar o site
-   localmente, selecione a opção Web para o host.
-   ![Formulário Novo Ambiente](https://deco.cx/docs/getting-started/creating-site/new-env-form.png)
+![Editar um site](https://deco.cx/docs/getting-started/creating-site/site-editor.png)
 
-Agora você tem seu próprio ambiente e espaço de trabalho isolado para fazer
-alterações no seu site sem precisar rodar seu código.
+## 3. Finalizar Configuração do Site
 
-## (Opcional) 5. Deploy do Seu Site
+Você será redirecionado para a página inicial do site:
 
-Se você quiser fazer o deploy do seu site usando o Hosting da Deco, você pode
-fazer isso clicando no botão "Add Deco Hosting" na página inicial do site ou no
-botão "Go live" no dropdown de ambientes.
+![Página Inicial do Site](https://deco.cx/docs/getting-started/creating-site/site-home.png)
 
-<Frame><img src="https://deco.cx/docs/getting-started/creating-site/go-live-btn.png" alt="Botão de Deploy do site" width="340"/></Frame>
+Se você quiser fazer o deploy do seu site usando o Hosting da Deco, você pode fazer isso clicando no botão “Add Deco Hosting” na página inicial do site.
 
 Seu site se tornará acessível através de uma URL pública como
-`https://deco-sites-maria-landing.deno.dev/`.
+`https://deco-sites-docs-deco.deno.dev/`.
 
 Esse deploy incluirá 5.000 visualizações de página (compartilhadas entre todos
 os sites da equipe). Se você precisar de mais visualizações de página, você pode
 [atualizar seu plano](https://deco.cx/en/pricing) no Deco Admin.
 
-## 6. Parabéns! Você Criou Seu Primeiro Site Deco
+## 4. Parabéns! Você Criou Seu Primeiro Site Deco
 
 É isso aí! Agora você pode editar seu site como quiser. Não se esqueça de seguir
 os próximos tutoriais para descobrir mais recursos e capacidades do Deco.cx.
+
+## Vídeo auxiliar
+
+<iframe
+  width="100%"
+  height="396"
+  src="{SRC AQUI}"
+  title="YouTube video player"
+  frameborder="0"
+  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
+  referrerpolicy="strict-origin-when-cross-origin"
+  allowfullscreen
+></iframe>
diff --git a/docs/pt/01_getting_started/02_creating_a_environment.mdx b/docs/pt/01_getting_started/02_creating_a_environment.mdx
@@ -0,0 +1,64 @@
+---
+title: Criando um ambiente
+description: |
+  Passo a passo de como criar um ambiente no seu site na Deco.cx.
+---
+
+Esta documentação vai te guiar pelo processo de criação e configuração do seu
+primeiro ambiente no seu site usando o Deco.cx.
+os ambientes são basicamente versões diferentes da sua loja/site que convivem em paralelo, cada uma
+com um propósito específico no fluxo de desenvolvimento e publicação.
+
+A partir daqui, você tem duas opções:
+
+1. Rodar seu site localmente usando seu ambiente de desenvolvimento local.
+   - Isso te dá o poder de modificar seu site alterando seu código, bem como
+     usando o Deco Admin.
+2. Criar um novo ambiente para editar seu site apenas através do Deco Admin.
+   - Aqui você pode fazer alterações no seu site sem precisar ter acesso ao
+     código do site.
+
+### Opção 1: Rodar Seu Site Localmente
+
+Para rodar seu site localmente, você precisa:
+
+1. Instalar o Deno na sua máquina. Você pode seguir as instruções no
+   [site do Deno](https://deno.land/).
+2. Clonar o repositório do site:
+   ```bash
+   git clone git@github.com:deco-sites/docs-deco.git
+   ```
+3. Entrar na pasta do repositório e iniciar o servidor:
+   ```bash
+   cd docs-deco
+   DECO_ENV_NAME=localhost deno task start
+   ```
+
+Agora, você pode modificar o código e ver as mudanças no Admin e vice-versa.
+
+### Opção 2: Criar um Novo Ambiente
+
+Ambientes são espaços de trabalho isolados onde você pode fazer alterações no
+seu site sem afetar o site ao vivo. Para criar um novo ambiente:
+
+1. Clique no botão "New" no dropdown de ambientes no Admin.
+   ![Botão Novo Ambiente](https://deco.cx/docs/getting-started/creating-site/new-env-btn.png)
+2. Escolha um nome e um host para o seu ambiente. Como não vamos rodar o site
+   localmente, selecione a opção Web para o host.
+   ![Formulário Novo Ambiente](https://deco.cx/docs/getting-started/creating-site/new-env-form.png)
+
+Agora você tem seu próprio ambiente e espaço de trabalho isolado para fazer
+alterações no seu site sem precisar rodar seu código.
+
+## Vídeo auxiliar
+
+<iframe
+  width="100%"
+  height="396"
+  src="{SRC AQUI}"
+  title="YouTube video player"
+  frameborder="0"
+  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
+  referrerpolicy="strict-origin-when-cross-origin"
+  allowfullscreen
+></iframe>
diff --git a/...etting_started/02_creating_a_new_page.mdx → ...etting_started/04_creating_a_new_page.mdx b/...etting_started/02_creating_a_new_page.mdx → ...etting_started/04_creating_a_new_page.mdx
diff --git a/pt/getting-started/creating-a-site.mdx b/pt/getting-started/creating-a-site.mdx
@@ -1,7 +1,7 @@
 ---
 title: Criando um Site
 description: |
-   Passo a passo de como criar um site na Deco.cx.
+  Passo a passo de como criar um site na Deco.cx.
 ---
 
 Esta documentação vai te guiar pelo processo de criação e configuração do seu
@@ -17,25 +17,9 @@ a estrutura e componentes comuns a páginas de aterrissagem.
 
 ![Escolhendo um template](https://deco.cx/docs/getting-started/creating-site/choose-template.png)
 
-## 2. Explorar o Template
-
-Depois de selecionar um template, você pode explorar seus componentes em modo
-compartilhado de visualização apenas. Isso permite que você explore as
-configurações e recursos do template sem fazer nenhuma alteração.
-
-![Editar um site](https://deco.cx/docs/getting-started/creating-site/site-editor.png)
-
-## 3. Salvar Seu Site
+### 1.1. Faça login na plataforma
 
-Para criar oficialmente seu site a partir do template, clique no botão "Use this
-template" no canto superior direito da página de administração para reivindicar
-a propriedade do site.
-
-![Salvar site para sua equipe](https://deco.cx/docs/getting-started/creating-site/save-site-btn.png)
-
-### 3.1. Faça login na Plataforma
-
-### 3.2. Dê um Nome ao Seu Site e Escolha uma Equipe
+### 1.2. Dê um nome ao seu site e escolha uma equipe
 
 Você será solicitado a escolher um nome para o seu site e uma equipe para
 salvá-lo:
@@ -48,69 +32,43 @@ Se você ainda não tiver uma equipe, uma será criada com um nome à sua escolh
 
 A Deco vai configurar seu site de acordo com o template que você escolheu.
 
-## 4. Finalizar Configuração do Site
-
-Você será redirecionado para a página inicial do site:
-
-![Página Inicial do Site](https://deco.cx/docs/getting-started/creating-site/site-home.png)
-
-A partir daqui, você tem duas opções:
-
-1. Rodar seu site localmente usando seu ambiente de desenvolvimento local.
-   - Isso te dá o poder de modificar seu site alterando seu código, bem como
-     usando o Deco Admin.
-2. Criar um novo ambiente para editar seu site apenas através do Deco Admin.
-   - Aqui você pode fazer alterações no seu site sem precisar ter acesso ao
-     código do site.
-
-### Opção 1: Rodar Seu Site Localmente
-
-Para rodar seu site localmente, você precisa:
-
-1. Instalar o Deno na sua máquina. Você pode seguir as instruções no
-   [site do Deno](https://deno.land/).
-2. Clonar o repositório do site:
-   ```bash
-   git clone git@github.com:deco-sites/maria-landing.git
-   ```
-3. Entrar na pasta do repositório e iniciar o servidor:
-   ```bash
-   cd maria-landing
-   DECO_ENV_NAME=localhost deno task start
-   ```
-
-Agora, você pode modificar o código e ver as mudanças no Admin e vice-versa.
-
-### Opção 2: Criar um Novo Ambiente
+## 2. Explorar o Template
 
-Ambientes são espaços de trabalho isolados onde você pode fazer alterações no
-seu site sem afetar o site ao vivo. Para criar um novo ambiente:
+Depois de selecionar um template, você pode explorar seus componentes em modo
+compartilhado de visualização apenas. Isso permite que você explore as
+configurações e recursos do template sem fazer nenhuma alteração.
 
-1. Clique no botão "New" no dropdown de ambientes no Admin.
-   ![Botão Novo Ambiente](https://deco.cx/docs/getting-started/creating-site/new-env-btn.png)
-2. Escolha um nome e um host para o seu ambiente. Como não vamos rodar o site
-   localmente, selecione a opção Web para o host.
-   ![Formulário Novo Ambiente](https://deco.cx/docs/getting-started/creating-site/new-env-form.png)
+![Editar um site](https://deco.cx/docs/getting-started/creating-site/site-editor.png)
 
-Agora você tem seu próprio ambiente e espaço de trabalho isolado para fazer
-alterações no seu site sem precisar rodar seu código.
+## 3. Finalizar Configuração do Site
 
-## (Opcional) 5. Deploy do Seu Site
+Você será redirecionado para a página inicial do site:
 
-Se você quiser fazer o deploy do seu site usando o Hosting da Deco, você pode
-fazer isso clicando no botão "Add Deco Hosting" na página inicial do site ou no
-botão "Go live" no dropdown de ambientes.
+![Página Inicial do Site](https://deco.cx/docs/getting-started/creating-site/site-home.png)
 
-<Frame><img src="https://deco.cx/docs/getting-started/creating-site/go-live-btn.png" alt="Botão de Deploy do site" width="340"/></Frame>
+Se você quiser fazer o deploy do seu site usando o Hosting da Deco, você pode fazer isso clicando no botão “Add Deco Hosting” na página inicial do site.
 
 Seu site se tornará acessível através de uma URL pública como
-`https://deco-sites-maria-landing.deno.dev/`.
+`https://deco-sites-docs-deco.deno.dev/`.
 
 Esse deploy incluirá 5.000 visualizações de página (compartilhadas entre todos
 os sites da equipe). Se você precisar de mais visualizações de página, você pode
 [atualizar seu plano](https://deco.cx/en/pricing) no Deco Admin.
 
-## 6. Parabéns! Você Criou Seu Primeiro Site Deco
+## 4. Parabéns! Você Criou Seu Primeiro Site Deco
 
 É isso aí! Agora você pode editar seu site como quiser. Não se esqueça de seguir
 os próximos tutoriais para descobrir mais recursos e capacidades do Deco.cx.
+
+## Vídeo auxiliar
+
+<iframe
+  width="100%"
+  height="396"
+  src="{SRC AQUI}"
+  title="YouTube video player"
+  frameborder="0"
+  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
+  referrerpolicy="strict-origin-when-cross-origin"
+  allowfullscreen
+></iframe>