De Marc Cohen, Developer Advocate

Há algumas semanas, lançamos o recurso Open in Cloud Shell, que permite que um hiperlink simples abra um shell de nuvem com um repositório do GitHub clonado automaticamente, arquivos abertos pré-selecionados no Cloud Editor e outros recursos para facilitar ao máximo a criação de conteúdo interativo. Hoje, estamos adicionando a funcionalidade de integrar seus tutoriais diretamente no Console do Google Cloud Platform e executá-los clicando em um link. Vamos examinar rapidamente a experiência de criação e do usuário:

Os tutoriais do Cloud Shell são criados usando a sintaxe Markdown (CommonMark), com extensões para oferecer vários recursos, como:

  • Criar um novo projeto 
  • Ativar a cobrança 
  • Abrir um arquivo 
  • Destacar um elemento da IU 
Os tutoriais do Cloud Shell oferecem a possibilidade de automatizar todas as funções acima e muitas outras usando uma sintaxe Markdown simples.

Ou seja, em vez de fornecer instruções indiretas, como "abra o arquivo foo.txt clicando no arquivo em destaque na imagem exibida acima", o tutorial pode dizer "clique aqui para abrir foo.txt", o que é muito mais direto e simples. Clicando nesse link, o efeito esperado ocorrerá diretamente no Cloud Console.

Veja alguns exemplos de casos de uso:

  • um tutorial de um serviço ou produto em que um aplicativo de exemplo reside em um repositório associado
  • uma descrição detalhada de um repositório que apresenta a estrutura do projeto às pessoas 
  • uma sequência de etapas de instalação de pré-requisitos e a criação de algo interessante (parecido com o arquivo INSTALL, encontrado em alguns repositórios de código aberto) 
Os tutoriais do Cloud Shell permitem que qualquer pessoa possa criar facilmente material educativo envolvente e integrado diretamente ao Cloud Console. Leia mais sobre esse recurso na documentação pública, que contém um tutorial de exemplo que mostra todas as novas funcionalidades com a sintaxe Markdown correspondente.

Este é um exemplo autoexplicativo bem simples. Esperamos que você goste de criar alguns tutoriais incríveis com esse recurso. Não se esqueça de nos dizer como foi a sua experiência, o que foi bom e o que poderia ser melhorado, usando o link "Feedback" no fim da página da documentação.