Painel de feedback da documentação da Juniper NETWORKS

Introdução

O Documentation Feedback Dashboard é um repositório provisório do feedback coletado na documentação do Juniper. É um lugar onde o redator da documentação reviews, analisa, reúne detalhes adicionais e, eventualmente, resolve o feedback (por meio de um GNATS PR ou sem um). O painel agora tem alguns novos recursos interessantes. Nosso objetivo é facilitar para escritores e gerentes monitorar, rastrear, relatar e corrigir o feedback da documentação.

Novos recursos e melhorias

• Aqui estão os novos recursos e melhorias em alto nível.
• Coluna de status
• Detalhes do produto/guia/tópico no “Título da página”
• Precisar de ajuda?
• Idade do Feedback
• Contato Jedi PACE
• Categorização de feedback por produtos, guias e tópicos
• Filtro “Gerente de Grupo” para mostrar repórteres de 1º a XNUMXº nível, incluindo auto
• Enfatizando o recurso “Comentários”

Coluna de status

• O recurso “Status” oferece benefícios como visibilidade clara, responsabilidade e monitoramento de feedbacktage.
• A opção “Archive feedback” ficará acinzentada até que o campo “Status” seja “New”. Atualizar o campo de status para outro que não “New” ativará a opção archive feedback.
• A opção “Criar um PR” ficará acinzentada até que não haja nenhum proprietário atribuído no campo “Proprietário”. Atribuir um proprietário ao feedback ativará a opção.
• A lista de status fornecida deve ser utilizada pelos escritores conforme necessário.

Status	Descrição
Novo	O “Status” padrão de um feedback recém-recebido. Não deixe o status como “Novo” por mais de dois dias.
Sob investigação	Defina o status como “Sob investigação” enquanto estiver investigando o feedback.
Em andamento	Quando a investigação estiver concluída e você começar a trabalhar para abordar o feedback, altere o status para “Em andamento”.
Não acionável	· Se for um feedback positivo e nenhuma ação for necessária, ou · se o feedback não tiver os detalhes necessários ou estiver incompleto, marque-o como “Não acionável” e arquive-o.
Duplicado	Se você identificar algum feedback duplicado, marque-o como “Duplicado” e arquive-o.
Requer suporte Jedi	Se você precisar de suporte dos especialistas do PACE (equipe Jedi) para entender ou abordar o feedback. Execute as seguintes tarefas, · Defina o status como “Requer suporte Jedi”. · Selecione “Sim” no campo “Precisa de ajuda?”. · Pesquise e selecione o especialista PACE Jedi no campo “PACE Jedi Contact”. Se você não conhece o especialista, deixe o campo como está. Quando terminar de trabalhar no feedback, defina o campo “Precisa de ajuda?” como “Recebido”, mas deixe o campo “Contato Jedi do PACE” como está.

Fixo (sem RP)	Depois de ter respondido ao feedback sem criar um RP.
RP criado	Se você criou um PR para abordar o feedback, o status será automaticamente definido como “PR criado”. Altere o status mais tarde, quando terminar de trabalhar no PR.
Corrigido, aguardando validação	Se o problema foi resolvido ou corrigido e aguarda validação.
Corrigido, PR fechado	Quando o PR for corrigido e fechado no GNATS, defina o status como “Corrigido, PR fechado” e prossiga com o arquivamento do feedback.

Detalhes do produto/guia/tópico no “Título da página”

• O proprietário do feedback pode ter uma ideia rápida sobre qual produto/guia/tópico o feedback se refere.
• A aparência do painel não é confusa com todos os comentários aparecendo na frente view.
• Isso ajudará os escritores, gerentes e a equipe do JEDI a entender a qual portfólio o feedback pertence.

Precisar de ajuda?

• Se precisar de ajuda para abordar ou resolver o feedback, levante uma bandeira escolhendo “Sim” no menu suspenso “Precisa de ajuda?”. Para ajudar você de forma eficiente, forneça informações detalhadas no campo “Detalhes adicionais” e especifique o tipo de suporte que você precisa da equipe JEDI. Isso notificará o alias JEDI e alguém da equipe Jedi coordenará com os escritores para estender sua expertise e ajuda.
• Selecione a opção “Não” se não precisar de ajuda. Não haverá nenhuma notificação enviada a ninguém quando “Não” for selecionado.
• Selecione a opção “Recebido” quando receber ajuda da equipe JEDI. Não haverá nenhuma notificação enviada a ninguém quando “Não” for selecionado.

Idade do Feedback

• Abaixo de “Received Date”, o sistema mostra um número que aumenta a cada dia. Esse número representa os dias decorridos desde o recebimento do feedback. Quanto maior o número, maior a idade do feedback.

Contato Jedi PACE

• Os escritores selecionarão um contato Jedi somente quando tiverem certeza da aplicabilidade do contato. Caso contrário, deixe o campo em seu padrão ao solicitar ajuda. Alguém da equipe Jedi reivindicará o feedback e se voluntariará para ajudar ou dar suporte.
• O campo “Contato Jedi PACE” é habilitado somente quando o sinalizador Precisa de Ajuda está marcado como “Sim”.
• Adicionar ou modificar detalhes do “PACE Jedi Contact” acionará uma notificação automática para o contato, marcando o alias Jedi na cópia. Esse recurso existe também para o campo “Feedback Owner”.
• A responsabilidade pela resolução ou pelo encerramento do feedback deve ser compartilhada pelo proprietário do feedback e pelo especialista do PACE (equipe Jedi).
• Isso ajudará a equipe de especialistas/JEDI a saber que sua ajuda/suporte é necessária para resolver o problema.

Categorização de feedback por produtos, guias e tópicos

• Além do título da página, dentro do feedback view, os detalhes do produto, do guia e do tópico serão exibidos.

Filtro “Gerente de Grupo” para mostrar repórteres de 1º a XNUMXº nível, incluindo auto

• Permite que os gerentes view a lista completa de feedback sobre suas equipes.
• Não há necessidade de aplicar vários filtros para extrair a lista abrangente de sua equipe.

Enfatizando o recurso “Comentários”

• Os comentários são frequentemente ignorados pelos donos do feedback e o recurso está subutilizado atualmente. Por isso, introduzimos um ponto vermelho sobre o ícone de comentários para mostrar se há algum comentário no feedback.
• Como os comentários têm o recurso “@” para notificar alguém, qualquer novo comentário adicionado notificará a pessoa e também destacará o ícone com um ponto vermelho.
• Para obter mais informações ou suporte no uso do painel de feedback, escreva para tech pubs-commentstechpubs-comments@juniper.net>

Documentos / Recursos

Painel de feedback da documentação da Juniper NETWORKS [pdf] Guia do Usuário Documentação Painel de Feedback, Painel de Feedback, Painel

Referências

• Manual do usuário