DEV Community

Fabrício Pereira Alves
Fabrício Pereira Alves

Posted on

Cansei de me perder no manual do PHP — então construí uma forma nova de estudá-lo

Se você leu meus dois posts anteriores, já sabe onde isso vai dar. Falei sobre a importância de ter um guia pra estudar PHP e sobre como a documentação oficial é a melhor fonte, só faltando organização. Este post é a coisa que estava por trás dos dois — o que eu acabei construindo.

Começa com uma dor bem específica.

A história

Há um tempo, decidi estudar o manual oficial do PHP de ponta a ponta. Abria o php.net, começava do início e ia anotando tudo num arquivo de notas: conceitos, pegadinhas, o importante de cada página.

Ótima ideia — por umas duas semanas. Depois, minhas anotações viraram um labirinto. Eu não sabia mais qual página já tinha lido, onde tinha anotado aquilo sobre sessões, e o índice do manual tem milhares de tópicos aninhados. O esforço todo ia pra me organizar, não pra aprender.

Procurei uma ferramenta que resolvesse isso: pegar a documentação oficial e colocar por cima dela uma camada de estudo — caminho, progresso, anotações no lugar. Não achei nada que fizesse exatamente isso.

Então construí. Chama PHPDocQuest.

O que é

Em uma frase: o manual oficial do PHP virado numa jornada de estudo.

Em vez de você se perder em 20 abas do php.net, o manual inteiro vira uma árvore navegável — todos os ramos oficiais (Language Reference, Function Reference, Security e cia.) num só lugar, expansível e buscável. Você lê, marca o que já estudou, anota, e acompanha seu progresso. Tudo sobre a fonte oficial, sem intermediário.

O que faz ele diferente

A ideia não é "mais um curso". É uma forma nova de navegar e estudar a documentação:

🌳 O manual como árvore. Os ~5 mil tópicos num índice expansível e buscável (atalho /). Você vê a estrutura inteira e nunca se perde no meio dela.

📖 Leitura lado a lado. Clicou num tópico? A página oficial abre num painel embutido, ao lado da árvore — você lê e marca sem perder o seu lugar. E se clicar num link dentro do manual, a árvore se sincroniza sozinha pra acompanhar.

Progresso que sincroniza. Marque um tópico (ou um ramo inteiro) e a barra sobe na hora. Fica salvo na sua conta e disponível em qualquer dispositivo — sem depender do navegador.

📝 A anotação mora no tópico. Nada de caderno solto que vira labirinto. Cada nota fica ao lado do conteúdo a que se refere, com autosave. (Esse era, literalmente, o meu problema original.)

🧭 Trilhas guiadas. Pra quem não sabe por onde começar, tem trilhas de estudo — caminhos passo a passo sobre o manual, um pra cada ponto de partida (do zero, pra quem já programa em outra linguagem, intermediário, avançado).

E de bônus: é gratuito, funciona em português e inglês, tem tema claro/escuro, e — coerente com o meu incômodo com rastreamento — sem Google Analytics nem cookies de terceiro.

Por baixo do capô (pra galera dev)

Já que aqui é o Dev.to: a parte que mais me ensinou foi a engenharia de dados.

Um pipeline próprio baixa e parseia as ~11 mil páginas HTML do manual oficial e reconstrói a árvore de ~5 mil tópicos — automaticamente, todo mês. O detalhe que mais me orgulha: o progresso do usuário sobrevive a essa atualização mensal, porque cada tópico é identificado por um slug estável, não por um ID numérico. Se fosse ID, cada reimport embaralharia tudo. Assim, página nova chega desmarcada, página removida vira uma linha inofensiva, e o que você já estudou continua lá.

Dá uma olhada

O PHPDocQuest está no ar, é grátis e nasceu de uma dor que provavelmente é sua também 👉 https://php.docquest.dev

Se você estuda pela documentação e já se perdeu como eu, talvez encaixe certinho. E se testar, manda feedback — tô melhorando ele direto, e ouvir quem usa é o que mais ajuda. 🙌

Bons estudos.

Top comments (0)