30 Dias na Vida de um Arquiteto de Conteúdo: Testando a Teoria na Prática

30 Dias na Vida de um Arquiteto de Conteúdo: Testando a Teoria na Prática

Um mergulho profundo nas atividades diárias de arquitetos de conteúdo, detalhando como a teoria se traduz em ações práticas para otimizar a gestão e a estrutura de conteúdo em uma empresa de tecnologia.

MundiX News·03 de julho de 2026·8 min de leitura·👁 2 views

Olá a todos!

No artigo anterior, explorei o fundamento teórico: quais são as responsabilidades de um arquiteto de conteúdo e quais tarefas ele executa. No entanto, qualquer descrição de cargo empalidece diante da prática real, quando a teoria colide com prazos, revisões e processos de negócios em andamento.

Hoje, proponho passar das palavras aos atos. Analisei o trabalho de uma equipe de quatro arquitetos de conteúdo durante um mês e preparei uma análise detalhada sem embelezamentos: mostrarei como as funções descritas anteriormente ganham vida e quais resultados foram alcançados em 30 dias. Tenho certeza de que este relatório permitirá que você veja o valor real de um arquiteto de conteúdo para a organização do trabalho da equipe em um sistema de documentação e para a otimização dos processos de trabalho. Prepare uma xícara de café, haverá muitos detalhes!

Mudança na Estrutura de Conteúdo na Base

Nos últimos anos de trabalho do departamento de escritores técnicos, nossa base de conteúdo cresceu significativamente, e a estrutura anterior deixou de dar conta. O trabalho desacelerou: a árvore de seções demorava muito para carregar, e materiais de diferentes produtos se misturavam nas pastas. Para corrigir a situação e restaurar a eficiência, iniciamos a reorganização da estrutura da base.

Após discussão em uma reunião de arquitetos, decidimos que era hora de permitir vários níveis de aninhamento de pastas na base. A classificação por nome da seção e tipo de artigo (por exemplo: seção-artigo, seção-instrução, FAQ, release notes) permitiu identificar conteúdo duplicado e configurar o uso de empréstimos (inheritance). Gastamos cerca de uma semana nisso, revisando manualmente mais de 30 mil seções.

Além disso, criamos pastas separadas para novas seções e concordamos que os arquitetos as classificarão regularmente — a cada seis meses ou um ano. Isso permitirá que os autores economizem tempo na fase de preparação e se concentrem no significado do texto, em vez de questões de classificação.

Verificações Regulares de Conteúdo

Review Workflow é um processo automatizado de revisão, comentário e aprovação de conteúdo técnico por especialistas. A principal tarefa desse processo de revisão é conectar escritores técnicos a especialistas de domínio (editores, testadores, analistas, desenvolvedores, gerentes de produto) sem o envio interminável de arquivos por e-mail e a troca de comentários em tickets.

Uma vez por ano, atualizamos o workflow para tornar o processo de revisão o mais transparente possível e livrar a equipe de trabalho manual desnecessário. Após a conclusão dos trabalhos em uma melhoria de cenário, descrevemos as alterações na base de conhecimento. Agora, as notificações se tornaram muito mais informativas: os funcionários veem imediatamente os prazos urgentes e os comentários, e arquivos importantes podem ser anexados diretamente ao e-mail, sem perder o contexto da discussão. Também corrigimos seriamente a contagem de estatísticas: o sistema considera apenas as seções necessárias e ignora as seções que foram aprovadas por seu autor, para que os relatórios de cobertura de conteúdo por revisão não distorçam a imagem real. Todas as mudanças em conjunto economizam o tempo da equipe e reduzem significativamente o risco de erros na transferência de tarefas.

Foram realizadas cerca de 25 melhorias, que consumiram pouco mais de duas semanas de trabalho. A atualização das instruções na base de conhecimento, sua verificação, a preparação de uma demonstração para os autores e sua realização consumiram cerca de três dias de trabalho.

Verificação do Uso de Variáveis no Texto das Seções

Nos textos das seções de nosso CMS, usamos intencionalmente variáveis em vez de nomes fixos de produtos, módulos ou da empresa. Este é um mecanismo chave para a reutilização de conteúdo: escrevemos o material uma vez, e o sistema insere automaticamente os valores necessários ao publicar para um produto específico. Essa abordagem transforma a base de conhecimento em uma fonte única. Se o nome do produto ou o nome legal da empresa mudar, não precisaremos editar milhares de artigos manualmente — basta atualizar o valor da variável em um local. Isso garante a precisão absoluta dos nomes em todos os materiais e acelera criticamente a publicação da documentação, permitindo escalar o conteúdo para novos produtos sem um aumento proporcional nos custos de mão de obra.

Para garantir que os autores não se esqueçam de usar variáveis, desenvolvemos um workflow que permite criar automaticamente tarefas para processar seções de documentos que especificam explicitamente o nome do produto ou da empresa em vez de usar variáveis.

O trabalho de criação do workflow consumiu 16 horas. Como resultado, na primeira execução, foram descobertos cerca de 928 seções de documentos em que os nomes de produtos e da empresa foram escritos manualmente. Mensalmente, com a reinicialização deste workflow, são criadas de 5 a 20 tarefas para os autores corrigirem o conteúdo.

Configuração de Publicação

Novos Tipos de Documentos

Na Positive Technologies, além do portal público help.ptsecurity.com, opera um portal interno acessível apenas aos funcionários. Este portal é um ponto de entrada único para o upload de documentação de produtos.

Todos os meses, colegas de diversos departamentos criam novos artefatos e os entregam para publicação. Arquitetos de conteúdo controlam a nomenclatura de arquivos para evitar erros e inconsistências na nomeação de documentos do mesmo tipo. Um padrão de nomenclatura unificado é crucial para a busca: quando os documentos são nomeados de forma consistente, os usuários encontram o que precisam mais rapidamente.

Este mês, adicionamos nove novos tipos de documentos ao sistema. A configuração de cada tipo levou de 5 a 10 minutos.

Atualmente, cerca de 5.000 documentos em diferentes idiomas estão disponíveis no portal interno.

Variáveis

Em nosso sistema de gerenciamento de conteúdo, uma variável é um objeto de texto dinâmico que é criado uma vez e inserido centralmente em texto ou gráficos. Ao publicar um documento, o sistema substitui automaticamente o nome da variável por um valor específico, dependendo da opção de produto selecionada. Os valores das variáveis são armazenados em tabelas especiais. Cada linha de tal tabela geralmente corresponde a uma variante de produto específica (versão, configuração), e as colunas — às variáveis.

Usamos variáveis no texto para garantir a consistência dos nomes (por exemplo, de produtos, módulos, componentes) em todos os materiais, bem como para atualizar dados em um local, em vez de editar cada documento separadamente. Isso economiza à equipe várias horas de trabalho manual em lançamentos que exigem a alteração de nomes. Além disso, permite aumentar a taxa de reutilização de texto, o que, por sua vez, reduz os custos de mão de obra para edição e tradução.

No período analisado, adicionamos vários novos valores às variáveis com nomes de produtos e nomes da empresa. Os valores foram traduzidos para todos os idiomas em que temos conteúdo de referência. No total, durante o mês, realizamos 4 dessas tarefas, gastando em média 45 minutos em cada uma.

Como exemplo, apresento um texto sobre suporte técnico, que usamos entre todos os produtos da empresa, substituindo apenas o valor da variável responsável pelos nomes curtos dos produtos ao publicar.

Gerenciamento do Ciclo de Vida do Conteúdo

Por ciclo de vida do conteúdo, entendemos a sequência de etapas pelas quais qualquer bloco de texto, imagem ou vídeo passa — da ideia à exclusão ou arquivamento. O gerenciamento adequado desse ciclo garante a demanda por materiais e a atualidade das informações na base de conteúdo. Para gerenciar o ciclo de vida, usamos ferramentas do sistema de documentação como taxonomia, marcação (tagging) e filtragem.

Taxonomia

A taxonomia em nosso CMS é uma hierarquia de metadados para classificar, filtrar e pesquisar conteúdo. No contexto de projetos mestres, a taxonomia garante a exclusão automática de blocos irrelevantes durante o processo de publicação. Por exemplo, essa abordagem é usada na geração de EULAs, onde a proporção de texto reutilizável é de cerca de 97%, e a parte variável é de não mais que 3%.

A taxonomia de versão permite distinguir claramente os materiais atuais das versões desatualizadas, para que os usuários não se confundam com as atualizações. Durante o mês, foram concluídas 11 tarefas para adicionar essa taxonomia.

A criação de cada elemento de taxonomia leva não mais que cinco minutos para um arquiteto de conteúdo, enquanto o autor economiza horas na preparação do conteúdo para um novo lançamento de produto.

A elaboração de novas classes taxonômicas leva muito mais tempo, pois requer recursos para pesquisar a viabilidade e aplicabilidade em projetos.

Verificações Regulares de Arquitetura

Regularmente limpamos a base de conteúdo, por exemplo, de imagens no formato incorreto e seções que existem na base, mas não são usadas em nenhum produto. Para isso, temos um conjunto de verificações automáticas que antes executávamos manualmente todos os meses. Agora, elas são executadas em um cronograma sem a participação dos arquitetos. Isso economiza o tempo da equipe e mantém a ordem. A exclusão de conteúdo não utilizado remove o ruído informacional e torna os resultados da pesquisa mais precisos: os usuários encontram apenas materiais relevantes.

Administração

Gerenciamento de Usuários e Seus Direitos

Durante o mês, adicionamos vários novos usuários ao sistema: concedemos licenças, atribuímos grupos de usuários e, consequentemente, concedemos direitos a vários objetos em nosso sistema de documentação.

Atualmente, na Positive Technologies, cerca de 320 funcionários estão envolvidos na preparação de documentação técnica: 23 escritores técnicos, 5 editores, 11 engenheiros de localização e cerca de 280 revisores e autores de outras unidades.

Atualização do Sistema

Além do trabalho planejado, tivemos que reagir a mudanças externas. O fornecedor lançou uma atualização para nosso sistema de gerenciamento de conteúdo. Implantamos e testamos a atualização em um ambiente de teste e decidimos não migrar para a nova versão devido à presença de um bug criticamente importante relacionado à publicação de conteúdo.

O teste da atualização consumiu cerca de quatro dias de trabalho.

Outras Tarefas

Configuramos a publicação das "Políticas de Suporte a Versões de Software". Esses documentos já estão disponíveis no portal de referência em formato web e PDF (por exemplo, para MaxPatrol VM: https://help.ptsecurity.com/ru-RU/projects/vm/common/eos). Também nos dedicamos à configuração da saída de documentação de projeto de acordo com GOST, eliminamos falsos positivos de verificações automáticas de conteúdo (adicionamos exceções para conteúdo específico: agora a equipe reage apenas a violações reais, e o tempo para preparação de conteúdo foi reduzido) e monitoramos a carga do sistema. Além disso, implementamos a capacidade de criar links cruzados entre a documentação de diferentes produtos da Positive Technologies e atualizamos uma série de artigos em nossa base de conhecimento interna.

As tarefas discutidas no artigo são um exemplo de um mês, mas também enfrentamos outras tarefas que não são abordadas neste material.

No total, durante o mês, a equipe de arquitetos de conteúdo realizou 104 tarefas. Pelos indicadores dos últimos três anos, em média, por trimestre, conseguimos realizar cerca de 170 tarefas.

Cada um dos arquitetos de conteúdo dedica aproximadamente 25-40% do tempo de trabalho a tarefas de especialidade; o restante do tempo é dedicado à preparação de documentação técnica no âmbito dos projetos.

Por quê? Nós mesmos enfrentamos as mesmas dificuldades que o resto da equipe: procuramos informações, criamos e publicamos conteúdo, trabalhamos no sistema. Vemos onde o processo está emperrado e podemos corrigir rapidamente a arquitetura, sem complicar a vida da equipe em prol de uma estrutura bonita. Graças a isso, projetamos soluções arquitetônicas não isoladas da realidade, mas com a compreensão das necessidades diárias dos autores.

Conclusão

Compilei todas as tarefas-chave do mês descritas em uma tabela para clareza. Abaixo, você pode ver quanto tempo foi gasto em cada área de trabalho.

Tarefa
Mudança na estrutura de conteúdo na base
Ajustes finais da nova versão do Review Workflow
Atualização de artigos na base de conhecimento sobre o Review Workflow, preparação e realização de demonstração para autores
Desenvolvimento de um cenário para verificar o uso de variáveis no texto das seções
Adição de novos tipos de documentos
Adição de valores de variáveis
Adição de elementos de taxonomia
Execução manual de verificações de arquitetura e controle de processamento de tarefas
Adição de usuários
Teste de atualização do sistema de documentação
Outras tarefas
Total
Tempo Gasto, Horas
40
20
24
16
1
3
1
4
2
32
73
216

Em um mês, gastamos cerca de 220 horas em tarefas de arquitetos de conteúdo. Em média, cada um de nós dedicou quase um terço do tempo a esse trabalho — 32% (aproximadamente 54 horas).

Como você pode ver, o trabalho de um arquiteto não se limita apenas à estrutura da base de conteúdo. Um arquiteto de conteúdo resolve problemas de qualquer nível: desde a parte visível para o usuário até a estrutura interna do sistema de documentação. Atuamos tanto como especialistas técnicos que configuram a ferramenta, quanto como guardiões de padrões, e como estrategistas que conectam produtos em um ecossistema unificado. Essa diversidade exige flexibilidade constante e um amplo escopo de conhecimento. Isso confirma que o papel do arquiteto está na intersecção do gerenciamento de conteúdo, desenvolvimento e projeto de sistemas.

🛡️⚡

Pare de pesquisar. Comece a hackear.

O MundiX é seu copiloto de pentest com IA: comandos exatos, análise de outputs e próximo passo na kill chain — em segundos.

Testar grátis por 7 dias →

Sem cartão para começar · Planos a partir de R$49/mês

📤 Compartilhar & Baixar

🧰 Ferramentas recomendadas

Divulgação: alguns links são patrocinados. Podemos receber comissão se você comprar — sem custo extra para você. Só indicamos o que faz sentido para a comunidade.

Aprendendo Kali Linux: Teste de segurança, pentest e hacking ético

Aprendendo Kali Linux: Teste de segurança, pentest e hacking ético

Com centenas de ferramentas pré-instaladas, a distribuição Kali Linux facilita o trabalho de os profissionais de segurança começarem a fazer testes de segurança rapidamente. No entanto, com mais de 600 ferramentas em seu arsenal, o Kali Linux também pode ser desafiador. A nova edição deste prático livro abrange as atualizações nas ferramentas e inclui uma melhor abordagem da análise forense e da engenharia reversa. Ric Messier, autor, não fica apenas no teste de segurança, mas também faz uma abordagem sobre a execução de análise forense, incluindo a análise em disco e na memória, assim como alguma análise básica de malware. • Explore as diversas ferramentas disponíveis no Kali Linux • Entenda o valor do teste de segurança e examine os tipos de teste disponíveis • Aprenda os aspectos básicos do pentest em todo o ciclo de vida do ataque • Instale o Kali Linux em vários sistemas, tanto físicos quanto virtuais • Descubra como usar diferentes ferramentas destinadas à segurança • Estruture um teste de segurança baseado nas ferramentas do Kali Linux • Estenda as ferramentas do Kali para criar técnicas de ataque avançadas • Use o Kali Linux para ajudar a criar relatórios quando o teste terminar “A abordagem concisa, clara e baseada na experiência adotada por Ric Messier para a introdução do Kali Linux e dos testes de cibersegurança é incomparável. Este livro é uma leitura excelente e acessível para iniciantes e um recurso valioso para qualquer pessoa.” —Alexander Arlt, Consultor sênior de segurança, Google

Ver na Amazon
Gshield 2 em 1 Hub Extensor Conector USB-C + USB-A e Adaptador de Rede Ethernet LAN RJ45 com 3 Entradas USB 3.0 até 5 Gbps em Liga de Alumínio para Computador e Notebook, Cinza

Gshield 2 em 1 Hub Extensor Conector USB-C + USB-A e Adaptador de Rede Ethernet LAN RJ45 com 3 Entradas USB 3.0 até 5 Gbps em Liga de Alumínio para Computador e Notebook, Cinza

Compatível com portas USB-C e USB-A, ideal para ampliar a conectividade de dispositivos como MacBook Pro e outros com portas USB-C. Inclui um adaptador USB-A extra, proporcionando uma conexão Ethernet estável e veloz de até 1 Gbps, perfeita para filmes, jogos online e videoconferências. Oferece três portas USB 3.0 com velocidades de transferência de até 5 Gbps, permitindo conectar mouse, teclado, discos rígidos e outros periféricos. Fabricado em alumínio durável, garantindo longa vida útil e resistência ao uso diário. Design compacto e leve, ideal para viagens de negócios e uso diário, facilitando o transporte e armazenamento. Funciona com Windows 10/8.1/8, Mac OS e Chrome OS, oferecendo versatilidade incomparável para diversas necessidades de conectividade. Assegura uma conectividade estável e rápida, perfeita para tarefas exigentes como transferência de dados, streaming e mais.

Ver na Amazon
Hacking APIs: Breaking Web Application Programming Interfaces

Hacking APIs: Breaking Web Application Programming Interfaces

Hacking APIs is a crash course on web API security testing that will prepare you to penetration-test APIs, reap high rewards on bug bounty programs, and make your own APIs more secure. You'll learn how REST and GraphQL APIs work in the wild and set up a streamlined API testing lab with Burp Suite and Postman. Then you'll master tools useful for reconnaissance, endpoint analysis, and fuzzing, such as Kiterunner and OWASP Amass. Next, you'll learn to perform common attacks, like those targeting an API's authentication mechanisms and the injection vulnerabilities commonly found in web applications. You'll also learn techniques for bypassing protections against these attacks. In the book's nine guided labs, which target intentionally vulnerable APIs, you'll practice: Enumerating APIs users and endpoints using fuzzing techniques Using Postman to discover an excessive data exposure vulnerability Performing a JSON Web Token attack against an API authentication process Combining multiple API attack techniques to perform a NoSQL injection Attacking a GraphQL API to uncover a broken object level authorization vulnerability

Ver oferta
Gray Hat Hacking: The Ethical Hacker's Handbook, Sixth Edition

Gray Hat Hacking: The Ethical Hacker's Handbook, Sixth Edition

Up-to-date strategies for thwarting the latest, most insidious network attacks This fully updated, industry-standard security resource shows, step by step, how to fortify computer networks by learning and applying effective ethical hacking techniques. Based on curricula developed by the authors at major security conferences and colleges, the book features actionable planning and analysis methods as well as practical steps for identifying and combating both targeted and opportunistic attacks. Gray Hat Hacking: The Ethical Hacker's Handbook, Sixth Edition clearly explains the enemy's devious weapons, skills, and tactics and offers field-tested remedies, case studies, and testing labs. You will get complete coverage of Internet of Things, mobile, and Cloud security along with penetration testing, malware analysis, and reverse engineering techniques. State-of-the-art malware, ransomware, and system exploits are thoroughly explained. Fully revised content includes 7 new chapters covering the latest threats Includes proof-of-concept code stored on the GitHub repository Authors train attendees at major security conferences, including RSA, Black Hat, Defcon, and B-Sides

Ver na Amazon
Bloqueador USB de privacidade de porta USB para PC, notebook, bloco de laptop,

Bloqueador USB de privacidade de porta USB para PC, notebook, bloco de laptop,

Proteção de privacidade aprimorada: protege o link de transmissão de dados para evitar roubo de informações, fornecendo proteção de segurança robusta que protege a privacidade do usuário durante transferências de arquivos e garante uma conexão segura para interações de dispositivos sem preocupações em vários ambientes Uso a longo prazo: a camada protetora resistente ao desgaste, combinada com um corpo de metal resistente, oferece gerenciamento de calor confiável e qualidade duradoura durante o uso diário Entrega eficiente de energia: a tecnologia de chip inteligente garante a identificação automática dos requisitos de energia, fornecendo carregamento eficiente alinhando-se com vários protocolos de carregamento rápido para maior conveniência Proteção contra sobrecarga: evitando riscos de sobrecarga, este bloqueador de dados USB protege a vida útil da bateria e garante um desempenho estável, mantendo um fluxo estável de energia para melhorar a longevidade do dispositivo de forma eficaz Prático de transportar: com atenção à portabilidade, este bloqueador de dados USB oferece um design compacto que é leve e fácil de transportar, melhorando a conveniência do usuário e operação eficiente

Ver na Amazon

📩 Newsletter MundiX

Receba novidades de cibersegurança + um checklist de pentest grátis. Sem spam.

Ao assinar você concorda em receber e-mails. Cancele quando quiser.