migrate

Leva uma raiz, com os seus Blueprints e documentos de nível superior, de uma versão do padrão para outra.

As migrações não são sequenciais

A parte que surpreende as pessoas, e uma escolha de design deliberada.

Ela vai direto de qualquer versão de origem para qualquer destino, comparando os dois instantâneos congelados na pasta versions/ do padrão. Da v1.0.0 direto para a v4.4.2 é um salto, não seis. Não há uma cadeia de atualizações a executar em ordem, nem nenhuma versão em que você precise parar no caminho.

Isso funciona porque, na hora de marcar a tag, o EIDOS.md é copiado tal e qual para versions/ com o nome semver completo dele, então duas versões quaisquer podem ser comparadas entre si.

O que ela toca

Ela reescreve o bloco ### Eidos Core do seu Framework.md e sobe o eidos_version.

As suas propriedades nunca são tocadas

### Custom Properties é seu. Só o bloco do núcleo se move com o padrão, que é a razão de editar aquele bloco à mão ser desaconselhado.

Como ela funciona

Ela facilita em vez de atropelar. Uma migração toca conteúdo real em Blueprints reais, então ela traz à tona o que pretende mudar antes de mudar.

Onde a migração é um julgamento em vez de uma reescrita mecânica (o salto de 4.3.2 para 4.4.0 pede que você registre a convenção de nomes que os seus arquivos já usam), ela lê a resposta na árvore, declara o que encontrou e pede que você confirme antes de escrever.

Ela carrega o histórico de versões

Uma das três skills que distribui uma cópia versionada de parte do padrão; aqui, os instantâneos congelados de versions/, para conseguir comparar duas versões quaisquer onde quer que esteja instalada. Por quê →

Relacionado

• Versionamento: os dois números de versão, e o salto atual.