# Documentação de handoff: Os 5 blocos essenciais A documentação de handoff é o registro que transfere acessos, decisões técnicas e rotinas de um site WordPress para quem vai operá-lo. Segundo o WordPress Developer Resources (2026), o WordPress tem 6 papéis de usuário com capabilities distintas. Sem mapear esses papéis, o repasse falha em semanas. Documentar bem corta o atrito da transição. A documentação de handoff é o conjunto de instruções que entrega um site WordPress pronto para outra pessoa operar sem depender de quem o construiu. Ela reúne credenciais, decisões de arquitetura, plugins ativos, rotinas de backup e o porquê de cada escolha. Na gestão de sites, esse registro separa um repasse limpo de um cliente preso ao fornecedor. Quem documenta o handoff devolve autonomia ao dono do site e reduz tickets de "como eu mexo nisso?". Veja como estruturar esse repasse em blocos que qualquer sucessor entende, sem garimpar e-mails antigos. A gente trata isso como parte da gestão de sites WordPress, não como burocracia opcional. --- ## O que é documentação de handoff e por que ela falha A documentação de handoff cobre 5 blocos: acessos, stack técnica, rotinas operacionais, decisões de projeto e plano de contingência. Em projetos sem esse registro, a maioria dos tickets de troca de fornecedor que chegam ao suporte da FULL nasce de uma senha perdida ou de um plugin que ninguém sabe para que serve. O problema raro é a falta de talento; é a falta de memória escrita.

Documentação de handoff: os 5 blocos e o que cada um previne
Bloco	O que registra	Falha que evita
Acessos	Usuários, papéis, hospedagem, DNS, e-mail	Cliente travado sem login
Stack técnica	Tema, plugins ativos, versão PHP	Atualização que quebra o site
Rotinas	Backup, atualização, monitoramento	Site sem backup válido
Decisões	Por que cada escolha foi feita	Retrabalho por desconhecer o contexto
Contingência	Restauração, contatos, staging	Pânico em incidente

A documentação de handoff que funciona é viva: mora em um documento versionado, não em um PDF estático que envelhece no primeiro update. --- ## O bloco de acessos: O coração da documentação de handoff O bloco de acessos é o item mais consultado da documentação de handoff e o que mais gera urgência quando falta. Ele lista cada credencial e cada papel de usuário do WordPress. O WordPress traz 6 papéis nativos (Administrador, Editor, Autor, Colaborador, Assinante e, em rede, Super Admin), cada um com capabilities diferentes, conforme o WordPress Developer Resources. Mapear quem tem qual papel evita repasse cego. Registre, no mínimo: login de administrador, painel da hospedagem, registrador do domínio, provedor de DNS, e-mail transacional e qualquer chave de API. Para o acesso ao servidor, vale documentar se o site usa WP-CLI e quais comandos rotineiros já existem. Use um gerenciador de senhas (1Password, Bitwarden) e na documentação aponte para o cofre, nunca cole a senha em texto puro. A documentação de handoff segura referência o cofre; ela não vira o cofre. Um painel de gestão de sites WordPress centraliza esses acessos e reduz o vai e vem. --- ## Stack técnica e decisões: O porquê que ninguém anota Documentar a stack técnica na documentação de handoff significa listar tema, plugins ativos, versão do PHP e a razão de cada peça. Boa parte do retrabalho em sites herdados vem de alguém desativar um plugin "que parecia inútil" e derrubar um formulário ou o cache. O sucessor precisa do contexto, não só da lista. Para cada plugin crítico, escreva uma linha: função, configuração não óbvia e o que acontece se desligar. Um site com WP Rocket, All in One Security e UpdraftPlus exige notas sobre regras de cache, firewall e agendamento de backup que não aparecem na interface. Registre também decisões estruturais: por que escolheu um ambiente de staging, por que o site roda em WordPress Multisite ou single, qual certificado SSL está em uso. Esse "porquê" é o que transforma a documentação de handoff em conhecimento transferível, e não em um inventário morto que o próximo gestor vai ignorar. --- ## Rotinas e contingência: A documentação de handoff que opera sozinha As rotinas são a parte da documentação de handoff que mantém o site vivo depois que você sai. Sem elas, um site pode passar meses sem backup válido até o dia em que precisa restaurar e descobre que nunca houve um. Segundo o estudo Veeam Data Protection Report 2024, uma fatia relevante das organizações não tem backups consistentes, e em WordPress isso se repete. Documente a cadência de cada rotina: frequência de backup automático e onde os arquivos ficam, janela de atualização de plugins, quem recebe os alertas de uptime. Inclua o plano de contingência: passo a passo de restauração, contato da hospedagem, e como subir uma cópia em staging antes de qualquer mudança arriscada. Um relatório de manutenção mensal serve de evidência de que as rotinas rodaram. A documentação de handoff completa permite que outra pessoa execute a contingência às 3 da manhã sem ligar para você, que é o teste real de um repasse bem feito. --- ## Documentação de handoff na FULL: 16 plugins sem dependência avulsa Boa parte da dependência de fornecedor nasce de licenças avulsas espalhadas: um WP Rocket no cartão do desenvolvedor, um Elementor PRO em outra conta. Quando o profissional sai, as renovações somem e o site degrada. A plataforma FULL resolve isso ao entregar 16 plugins premium ativados em um clique, sob a conta do dono do site, com a documentação de handoff já refletindo um único ponto de controle. No plano PRO, por R$849,90 para até 10 sites, o custo cai para cerca de R$85 por site, e cada licença passa a viver no painel de planos da FULL, não no e-mail de quem foi embora. A gente vê no suporte que centralizar ativação encurta o handoff: o sucessor herda acessos e plugins no mesmo lugar. ---

Perguntas frequentes sobre documentação de handoff

É possível fazer documentação de handoff sem usar nenhum plugin extra?

Sim. A documentação de handoff é um documento, não um plugin: um arquivo versionado no Google Docs ou Notion já cobre os 5 blocos. Plugins como UpdraftPlus ajudam nas rotinas de backup, mas o registro em si independe deles. O que não pode faltar é o link para o cofre de senhas e a lista de papéis de usuário do WordPress.

Por que a documentação de handoff em PDF estático costuma falhar depois de meses?

Porque o site muda e o PDF não. Um plugin atualizado, uma senha rotacionada ou um novo papel de usuário tornam o PDF obsoleto em semanas. A documentação de handoff precisa ser viva: um documento editável e versionado, com data da última revisão visível, para o sucessor confiar no que lê em vez de descobrir que metade está desatualizada.

Quanto tempo leva para montar uma documentação de handoff de um site WordPress?

Para um site institucional padrão, de 2 a 4 horas concentram os 5 blocos. O bloco de acessos leva cerca de 30 minutos; stack e decisões consomem a maior parte, porque exigem explicar o "porquê". Em sites com WooCommerce ou Multisite, reserve o dobro: há mais integrações e papéis de usuário para mapear.

A documentação de handoff substitui um contrato de manutenção com a agência?

Não. A documentação de handoff transfere conhecimento operacional; o contrato define responsabilidade e SLA. As duas coisas convivem: mesmo com manutenção contratada, o dono do site deve ter o registro de acessos e rotinas para nunca ficar refém. Quando o vínculo termina, a documentação garante que a transição para outro fornecedor não comece do zero.

Como validar se a documentação de handoff está realmente completa?

Aplique o teste do estranho: peça a alguém que nunca tocou no site para restaurar um backup e adicionar um usuário usando só o documento. Se essa pessoa conseguir sem perguntar nada, a documentação de handoff passou. Se travar em qualquer ponto, esse ponto é exatamente o que falta detalhar. Esse teste vale mais que qualquer checklist genérico.

--- ## Próximos passos para um repasse sem reféns A documentação de handoff madura não é um anexo de fim de projeto; é um documento vivo que cresce junto com o site e devolve autonomia ao seu dono. Comece pelos acessos, descreva o porquê de cada decisão técnica e prove que as rotinas rodam. Um modelo prático é cruzar este registro com um checklist de entrega de site e um checklist de manutenção, que transformam o repasse em rotina repetível. Para aprofundar a operação de portfólios inteiros, o FULL Academy reúne guias de gestão, segurança e performance em um só lugar. Documente como se fosse você quem vai herdar o site daqui a um ano sem lembrar de nada.

Legenda: a documentação de handoff organizada em blocos torna o repasse auditável e independente do fornecedor original.