format
Você já escreveu alguma coisa: um despejo mental, notas brutas, prosa meio
formada. O format leva isso para a forma sem acrescentar nada.
Ele funciona sobre um Blueprint de coleção, ou sobre um documento de nível superior livre que você acrescentou. Este último não tem shape com que casar, então é organizado segundo o estilo da casa em vez de conferido contra um.
A única regra: preservar, não encher
Seção intitulada “A única regra: preservar, não encher”Mantém a sua redação. Ele realoca frases para a seção a que pertencem e arruma a gramática e o markdown. Ele não reescreve a sua voz nem infla três palavras até virarem um parágrafo.
Não acrescenta nada de substância. Nenhum comportamento, intenção, decisão, escopo ou critério de aceitação inventado. As decisões de produto que não estão na página não cabem ao agente.
Traz as lacunas à tona; não as preenche. Uma seção sem nada embaixo é
omitida: o shape é um andaime, não uma lista de verificação. Para uma que
claramente deveria ter conteúdo, quase sempre a de não-objetivos, ele mantém o
título com um <!-- TODO: … --> curto e aponta isso. Um buraco honesto é melhor
do que conteúdo inventado.
Marca qualquer coisa inferida. Se ele adivinhar um title, ou arquivar uma
frase solta sob um título que ele escolheu, ele sinaliza isso para você confirmar
ou corrigir.
O que conta como formatação
Seção intitulada “O que conta como formatação”Mais do que mover parágrafos. Dentro e abaixo das seções do shape, ele vai:
- Tirar conteúdo rico de uma única linha: um modelo de dados para uma tabela, uma sequência para uma lista numerada.
- Acrescentar subtítulos
####dentro de uma seção que tem estrutura interna. - Manter curtas as afirmações verificáveis, apontando para uma tabela ou subseção para o detalhe em vez de espremê-lo em uma linha.
- Transformar referências a outros Blueprints em links markdown, na convenção de nomes do Framework. Transformar um nome em um link é formatação, não acrescentar conteúdo, então está inteiramente no escopo.
Isto não
Seção intitulada “Isto não”Desenvolver conteúdo novo é o eidos. Pensar uma ideia
antes de escrever qualquer coisa é o iterate. O
format é uma passada de mover e dar forma dentro de um único arquivo.