Solucionar problemas e publicar uma versão
Objetivos de aprendizagem
Após concluir esta unidade, você estará apto a:
- Descrever onde você pode verificar a integridade da versão no Trailmaker Release.
- Explicar a diferença entre um erro e um aviso no Trailmaker Release.
- Descrever como publicar conteúdo com o Trailmaker Release.
A página Problemas da versão
Ao longo dos módulos Noções básicas do site de capacitação, Configuração do site de capacitação, Escrever para um site de capacitação e Noções básicas do Trailmaker Content, além das unidades deste módulo, exploramos como criadores de conteúdo e gerentes de versão colaboram para planejar, criar e preparar conteúdo para o site de capacitação da sua empresa. Agora, depois que suas partes interessadas tiveram a chance de revisar o conteúdo preparado na visualização da versão no site de capacitação, um gerente de versão fará com que o conteúdo esteja pronto para ser publicado.
Dependendo do tamanho da sua empresa, pode haver várias funções contribuindo com conteúdo para uma versão, incluindo módulos, arte de emblema, imagens e conteúdo localizado. Com toda essa colaboração acontecendo, não é surpresa que às vezes problemas apareçam no seu conteúdo quando ele está sendo preparado para ser publicado. Talvez um módulo referenciado numa trilha esteja ausente, ou um teste esteja ausente de uma unidade, ou os atributos de acessibilidade de uma imagem estejam ausentes. Felizmente, um gerente de versão, como a Marisol, tem uma ferramenta para monitorar esses tipos de problema e garantir que eles sejam resolvidos antes que uma versão seja publicada.
No Trailmaker Release, a página da versão mostra um ícone de aviso e um banner vermelho quando a versão contém quaisquer avisos ou erros.
Quando Marisol clica no link View Errors and Warnings (Exibir erros e avisos) no banner vermelho, ela é direcionada para a página de problemas da versão. Esta página separa os problemas em duas seções: problemas relacionados à versão e problemas relacionados ao conteúdo.
Avisos versus erros
Um aviso é um problema que afeta a forma como os alunos aproveitam seu conteúdo. Para fornecer aos seus alunos a melhor experiência, você provavelmente vai desejar que os criadores de conteúdo corrijam esses problemas. De qualquer maneira, o Trailmaker não o impede de publicar. Alguns exemplos de avisos são:
- Um módulo tem uma imagem que o site de capacitação não consegue acessar porque a imagem está protegida por um firewall.
- Uma unidade tem códigos HTML que não são compatíveis com o Trailmaker Content e isso faz com que a formatação do conteúdo pareça estranha no site de capacitação.
- Falta uma imagem no texto alt e os leitores de tela digitais não conseguem descrever a imagem para utilizadores com deficiências visuais.
A versão de Marisol tem um aviso: o módulo Objetivos de vendas da Pure Aloe contém uma unidade com HTML inválido porque uma de suas imagens não possui texto alternativo para acessibilidade.
Um erro é um problema que afeta os requisitos técnicos para a publicação de conteúdo, e o Trailmaker o impede de publicar a versão. Alguns exemplos de erros são:
- Um módulo ou uma trilha está na lista da versão, mas o backpack do conteúdo não foi adicionado à versão.
- Um nome de API na lista de versões já está sendo usado em outra parte do conteúdo.
A versão da Marisol tem um erro: a trilha Vender bem na Pure Aloe, que está inclusa na versão, não foi carregada. Isso significa que o item de manifesto da trilha foi adicionado à versão, mas o backpack da trilha não foi adicionado à versão a partir do Trailmaker Content.
Mais um segredo: o Trailmaker Content identifica um monte de problemas antes do Trailmaker Release reportá-los. Por exemplo, se Marisol adicionar um módulo a uma versão, mas esquecer de incluir a arte do emblema ou um teste, o Trailmaker Content mostra uma janela para avisá-la que esses artefatos estão ausentes.
Com essas ferramentas úteis, Marisol pode identificar e resolver problemas potencialmente problemáticos no conteúdo antes da publicação.
Publicar a versão
Quando uma versão não reporta mais erros ou avisos, a página da versão exibe um banner azul, indicando que a versão está pronta para ser publicada.
Para publicar o conteúdo, tudo o que Marisol precisa fazer é clicar em Publish (Publicar) na página da versão.
O Trailmaker exibe então uma janela de confirmação, onde Marisol tem uma última chance de cancelar ou seguir em frente com a publicação. A janela de confirmação lista o número de itens que estão sendo processados na versão e confirma que não há erros ou avisos.
Pronto! Com dois cliques, Marisol finalmente publicou a mais recente versão na coleção de conteúdo da equipe de vendas. Os alunos da equipe de vendas da Pure Aloe agora podem acessar todos os novos conteúdos que Cindy e a empresa trabalharam tanto para criar e manter.
Baixar backpacks de conteúdo publicado
Antes de Marisol fazer uma pausa para o café muito necessária, ela tem mais uma tarefa a concluir. Ao longo deste módulo, vimos que tanto Marisol quanto Cindy precisam importar backpacks em seu espaço de trabalho local do Trailmaker Content a fim de obter conteúdo pronto para lançamento.
Lembre-se que um criador de conteúdo, como Cindy, pode baixar backpacks de conteúdo em que está trabalhando em seu espaço de trabalho local do Trailmaker Content. Ela pode, então, enviar os backpacks para o sistema de controle de versão (VCS) da empresa para que outros colaboradores, como Marisol, possam encontrar e importar o conteúdo para seus espaços de trabalho. Para obter uma atualização sobre este fluxo de trabalho, confira o módulo Noções básicas do Trailmaker Content.
Os backpacks baixados do Trailmaker Content refletem o conteúdo do espaço de trabalho do criador de conteúdo, mas não refletem necessariamente a versão mais recente do conteúdo que foi publicada em uma versão. Outros colaboradores podem ter importado os backpacks para seu espaço de trabalho e feito alterações antes de publicar o conteúdo.
Para obter backpacks que reflitam a versão mais recente do conteúdo publicado em uma versão, Marisol pode baixar backpacks da seção Conteúdo publicado do aplicativo Trailmaker Release.
Marisol pode colocar o backpack no VCS de sua empresa para que outros colaboradores possam acessar a versão mais recente do conteúdo publicado. Da próxima vez que um criador de conteúdo quiser fazer atualizações, ele pode importar esse backpack para o espaço de trabalho do Trailmaker Content e ter confiança de que está trabalhando com a versão mais recente lançada.
Juntos, toda a equipe da Pure Aloe pode celebrar o lançamento bem-sucedido do seu novo site de capacitação da plataforma Trailhead.