Diretrizes para postagens de convidados.

Versão 1.0, Publicado em:10 de Julho de 2023

Sobre o blog Guia Dev

O blog nasceu em 2021 no site Guia Dev como um complemento ao conteúdo publicado na seção “O Guia”.

O foco do blog é trazer uma visão mais pessoal da pessoa autora, porém não impositiva, sobre assuntos relacionados à área de desenvolvimento de software, oferecendo um conteúdo que leve a pessoas leitoras o conhecimento e experiências reais da mesma.


Público Alvo.

O público principal é pessoas desenvolvedoras de software como: Devs, Arquitetos(as), Engenheiros(as). Contudo também se estende à demais papéis presentes no processo de desenvolvimento de software como: PM’s (Product Managers, PO’s (Product Owners), Analistas de Negócio, Tech Leaders, UX/UI Designers, Designers de Produto, Testers, QA’s, DevOps, Admin. de Sistemas, DBA’s, Analistas de Infra, dentre outros(as).

Destaca-se ainda como público empresas de todos os portes, considerando desde pequenas startups a grandes empresas.


Diferença entre Temas do Guia e o Blog.

Os Temas do Guia possuem uma abordagem mais ampla sobre um assunto, com conteúdo mais estruturado e detalhado visando abordar de forma mais completa tópicos associados ao tema, além disso o texto é redigido de forma a ser mais impessoal, compilando visão geral, boas práticas e pontos de atenção, preferencialmente apoiados por referências externas consistentes sobre o tema, como livros, artigos, ou outras fontes de conteúdo pública e confiável.

O conteúdo do blog não possui utilização direta em materiais que envolvam a consultoria, treinamentos ou outros serviços do Guia Dev direcionados a empresas, embora possa ser indicado para leitura. Diferentemente do Blog, o conteúdo dos Temas, mantido por integrantes do Guia Dev, pode ser utilizado no trabalho do Guia Dev para Empresas.

Os Temas do Guia são publicados em seção separada do blog e categorizados a partir dos Pilares do desenvolvimento de software.

Assuntos desejados

Os assuntos desejados para postagens podem estar associados a temas ou tópicos relacionados aos Pilares do desenvolvimento de software:

  • Negócio.
  • Arquitetura de software.
  • Linguagens e Ferramentas.
  • Código Fonte.
  • Integração Contínua.
  • Entrega Contínua.
  • Pessoas.

Mas podem também trazer temas que mesmo não estando diretamente relacionados a um Pilar, estejam associados a questões que orbitam o desenvolvimento de software como:

  • Mercado de TI.
  • Liderança.
  • Auto organização.
  • Visão estratégica/sistêmica.
  • Dentre outros…

Do conteúdo

O conteúdo das postagens pode contemplar abordagens como:

  • Diferentes ângulos sobre um determinado assunto.
  • Relatos de experiências próprias.
  • Guia com instruções/dicas de como trabalhar com um assunto..
  • Lista de dicas de boas práticas e/ou pontos de atenção sobre um assunto.
  • Tendências, dados e insights da área.
  • Análises sobre cases públicos de sucesso ou insucesso na aplicação de um assunto.

O conteúdo deve apresentar a visão da pessoa autora sem impor uma definição de certo e errado, buscando expor pontos positivos e de atenção com relação a um tema, de forma que a pessoa leitora possa chegar a suas próprias conclusões.

O texto deve ser inclusivo, considerando vários níveis de audiência, buscando aplicar também uma linguagem neutra, contudo ainda seguindo as normas gramaticais. Exemplos:

  • O desenvolvedor de software, usar: A pessoa desenvolvedora de software.
  • Um arquiteto, usar: Um(a) arquiteto(a)..
  • Todos no processo, usar: Todas pessoas no processo, ou, Todos(as) no processo.

O objetivo é abraçar a neutralidade de gênero sem entrar em conflitos sobre a gramática normativa, mantendo o foco do leitor no tema em si da postagem.


Sinta o estilo das postagens existentes.

Para entender melhor o tom e formato básico (introduções curtas, títulos e subtítulos, parágrafos curtos, imagens que agregam valor, quadros informativos, elementos que quebrem “textões”, etc.). Leia algumas postagens na íntegra e explore.

O tom do conteúdo deve ser amigável, podendo ser provocativo mas não ofensivo. A escrita pode ser mais conversacional e menos corporativa, trazendo uma visão/introdução inicial, passando pela elaboração da ideia e com um desfecho que gere uma conclusão ou convide a pessoa leitora a uma reflexão.


Referências externas.

Qualquer referẽncia a um texto não autoral deve ser referenciada. Exemplo: “O coração do software está na sua capacidade de resolver problemas relacionados ao domínio para o seu usuário.” por Eric Evans.

Qualquer imagem utilizada, não autoral, deve ser referenciada. Exemplo: A imagem X foi composta a partir de ilustrações de: Fundo vetor criado por macrovector - br.freepik.com

Requisitos da postagem

Comprimento mínimo: 700 palavras.

Imagem de capa: Deve seguir um estilo vetorial/desenho, com dimensões de 760x420 px no formato png ou jpg, tamanho máximo de 150kb. Sugestão de banco de imagens: Freepik. Caso exista dificuldades para criar a imagem de capa, o time Guia Dev pode criar.

Introdução: O texto inicial deve apresentar o tópico e informar o que o post abordará. Na página home do site o texto inicial é cortado a partir de 200 caracteres. Na página principal do blog o texto é cortado a partir de 400 caracteres. Tais números são referências limites, podendo ser configurados pelo Guia Dev caso a quebra do texto comprometa a leitura introdutória.

Biografia: É necessário informar os dados abaixo (no aceite das diretrizes) para composição da Biografia (Veja exemplo da página de biografia a ser criada).

  • Foto: Imagem ou link de imagem nos formatos JPG ou PNG (tamanho mínimo de 200x200 px) com a foto para exibição na página de biografia no Guia Dev.
  • Nome: Nome desejado para exibição nas postagens e página de biografia no Guia Dev.
  • Profissão/Papel: Nome da profissão e/ou papel que atua para exibição na página de biografia no Guia Dev.
  • Links externos: Links para páginas pessoais ou redes sociais como Linkedin, Twitter, Instagram.
  • Descrição: Texto descritivo falando sobre a pessoa convidada, destacando sua formação, jornada profissional ou outros detalhes que desejar.

Backlinks: Limite de 3 por postagem, incluindo referências a textos externos e não considerando referências de imagens. Se necessário um número maior, este pode ser alinhado com o Guia Dev.

Fluxo para publicação da postagem

Abaixo segue o fluxo contemplando o envio de postagem até a publicação.

  • Guia Dev e Pessoa Convidada: conversa inicial para apresentações, troca inicial de ideias, entendimento dos temas possíveis, linha de pensamento, estilo de conversação/escrita.
  • Pessoa Convidada: leitura/aceite das diretrizes para postagem no blog Guia Dev e envio dos dados de Biografia (Aceite realizado por email).
  • Pessoa Convidada: definição do tema da postagem (não necessariamente o título).
  • Guia Dev: Aceite do tema.
  • Pessoa Convidada: escrita e envio do conteúdo para:
    • Email: blog@guia.dev.
    • Assunto: Guest Posting - TITULO DA POSTAGEM.
    • Corpo: Instruções gerais caso houver.
    • Conteúdo em anexo: Conteúdo a ser postado no formato preferencial PDF (ou DOC) e as imagens utilizadas.
  • Guia Dev: Revisão/Aprovação do conteúdo (pode haver sugestões de ajustes).
  • Guia Dev: Inclusão da postagem no site do Guia Dev em ambiente de staging.
  • Pessoa Convidada: Revisão/Aprovação da postagem no ambiente de staging.
  • Guia Dev e Pessoa Convidada: Definição da data de publicação no site em produção.
  • Guia Dev: Publicação da postagem, incluindo promoção via perfil do Guia Dev no Instagram e no Linkedin.

O processo visa garantir que o conteúdo a ser postado siga as diretrizes estabelecidas e que tanto Guia Dev e Pessoa Convidada estejam em pleno acordo com o conteúdo final a ser publicado, através de um trabalho conjunto e colaborativo.

Promoção da postagem

O Guia Dev fará assim que publicada a postagem, promoção do conteúdo através dos canais:

  • Instagram: @guia_dev, com uma publicação no feed do perfil e um story.
  • Linkedin: Guia Dev, com uma publicação na page do perfil.

É sugerido/esperado que a pessoa autora da postagem também compartilhe em suas redes, preferencialmente recompartilhando o compartilhamento dos canais citados ou fazendo link para a postagem e referenciando em cada canal o perfil do Guia Dev.