Uma das razões pelas quais o WordPress é um CMS tão popular é que é muito fácil começar a usar este site. Escolha um nome de login e uma senha e pronto. Embora o primeiro obstáculo na estrada possa ser a escolha de um tema, o Customizador percorre um longo caminho para resolver alguns dos problemas iniciais de "como seria o seu site"?

Outro momento emocionante na jornada do WordPress de um novo usuário é geralmente quando algo inesperado acontece. Você provavelmente já teve esse momento; Você pensa (ou grita) "Não consigo fazer X!" Ou "O que esta mensagem significa?"

Claro, sempre há o momento da lista de desejos: "Como faço para adicionar texto, imagens ou outros recursos ao meu site?" "

Ao contrário do software que você instala e executa em seu computador, o WordPress não tem um sistema de ajuda que aparece quando você pressiona F1, mas certamente precisa de uma resposta para essas perguntas irritantes. Provavelmente você foi referido Codex WordPress quando você encontra um problema. Talvez você tenha se intimidado com a linguagem técnica quando chegou lá, ou você acha que Codex é para programadores (não é).

Se alguma das coisas que você acabou de ler refletem sua experiência em encontrar uma solução para um problema do WordPress, então a equipe de documentação do WordPress ouviu você. Vai melhorar, mas você vai precisar de um pouco mais de paciência.

O futuro da documentação do WordPress se chama “HelpHub” e estará pronto em 2018.

O que há de errado com o WordPress Codex?

Para iniciantes do WordPress, o WordPress Codex é um recurso importante e os artigos são geralmente úteis. Ele lata será difícil encontrar o item certo que você está procurando. A página inicial do Codex tenta apontar a direção certa, com uma variedade de links.

Bem próximo ao topo, "Aprenda a usar o WordPress". Parece o lugar certo. Em seguida, você verá links para dois artigos que parecem cobrir o mesmo terreno.

O primeiro da lista é Introdução ao WordPress, que é apenas outro conjunto de links. É bom se perder tudo isso, mas você também pode ficar confuso ao ver alguns dos itens listados nas seções Iniciantes e Intermediário.

Introdução ao wordpress

Um desses artigos para iniciantes e intermediários também está vinculado à primeira página, logo após o início. O nome dele é Novo no WordPress - Por onde começar . Este artigo oferece um "plano passo a passo bem escrito para começar". Ele aconselha você a planejar seu site, instalar o WordPress, escolher um tema e escolher plug-ins. Este artigo está repleto de links para tratamentos mais aprofundados, mas com descrições desses artigos.

Da mesma forma, lidar com um problema também pode ser constrangedor. A seção da página inicial, O que você precisa saber sobre o WordPress, mostra a categoria ajudar. Aqui você encontrará links para perguntas frequentes e artigos sobre problemas de instalação, design, layout e tratamento de comentários de spam.

Muitas vezes, quando você recebe uma mensagem de erro ou um problema intrigante que não se encaixa em uma das categorias oferecidas, isso leva você para os Fóruns. Você pode obter um link para o artigo certo que aborda seu problema ou algo relevante que outra pessoa usou para resolver um problema semelhante.

Dica: A página Solução de problemas, em Desejado, fornece um bom resumo do como escrever um ótimo pedido de suporte. Leia isso antes de ir para os fóruns!

O que é HelpHub?

Vamos olhá-los HelpHub Objectives, conforme indicado nas especificações do projeto.

Para os usuários, os objetivos são simples:

  • Substitua o conteúdo suporte (principalmente no Codex) com artigos de alta qualidade e de fácil compreensão.
  • Crie um repositório pesquisável que facilite o acesso dos usuários ao conteúdo.

HelpHub também oferece benefícios para a equipe de suporte do WordPress:

  • Reduza a quantidade de postagens no fórum de suporte, tornando mais fácil encontrar respostas no HelpHub.
  • Forneça uma referência à qual os voluntários do fórum de suporte podem se vincular a perguntas comuns

Modelos: Mozilla e DevHub

Os modelos são muito semelhantes a outros sites complexos e aplicativos com sobrenomes conhecidos como Apple, Google, Mozilla (Firefox). Ao chegar ao site, você pode fazer uma pergunta e encontrar as respostas para essa pergunta ou uma solução para um problema que está tendo.

Para ter uma ideia do que é HelpHub, verifique help.mozilla.org, o site de suporte para o navegador Firefox, o cliente de e-mail Thunderbird e uma variedade de outros produtos e projetos.

Hoje, se você visitar help.mozilla.org, verá uma lista de produtos Mozilla. Clique em Firefox , e você obtém um conjunto de áreas como Instale e atualize , Gerenciar preferências e complementos e Proteja sua privacidade . Clique em qualquer um desses botões para obter uma série de artigos relacionados a esse botão.

Mais ao ponto, olhe para o novo DevHub do WordPress. A equipe de documentação chama este último de DevHub. O site fornece links para manuais de desenvolvedor existentes para criar temas, desenvolvedores de plugins, pessoas que desejam aprender mais sobre a interface de programação REST e a nova interface de linha de comando (WP-CLI).

O líder da equipe de documentação Jon Ang descreve a diferença entre DevHub e HelpHub assim: "Se alguém está perguntando, ' como posso utiliserWordPress“, Ele deve pensar em HelpHub. Se alguém está se perguntando, como faça algo com o WordPress, eles deveriam pensar no DevHub.

Cada um dos manuais é pesquisado, mas uma pesquisa global ainda não é possível.

Falando em pesquisa, Mozilla, Google e muitos outros sites de ajuda oferecem uma caixa de suporte de pesquisa No geral. O HelpHub do WordPress também oferece isso. A equipe está procurando um mecanismo de pesquisa mais rápido e eficiente do que o mecanismo de pesquisa WordPress atual.

Quando o HelpHub estará disponível

Em uma entrevista de junho de 2017 ao WPTavern no WordCamp Europe, o líder da equipe Doc Jon Ang disse que esperava que uma primeira versão do site estivesse pronta até o final de 2017, com o projeto concluído até o final de XNUMX. ano passado .

A equipe Doc corrige ativamente bugs no código, com um evento semanal de “eliminação de bugs”. O grupo Documentos importa conteúdo de páginas existentes do Codex, formatando-as e editando-as para melhor legibilidade.

Quando estiver pronto, este será o lugar onde você poderá obter informações e ajuda do WordPress. Você pode pesquisar uma área específica no HelpHub, se não tiver certeza de qual componente do WordPress foi afetado.

Este não é um resultado final, mas agora você pode conferir o Site de suporte HelpHub hoje.

Encenação do Helphub

É isso neste tutorial, o que você acha desta nova documentação?