How-to-use

How to use (como usar este mapa)

Esta pasta é ao mesmo tempo um vault do Obsidian e uma wiki do Azure DevOps. Os dois leem os mesmos arquivos Markdown, então você escreve num lugar e vê nos dois.

Montar no Azure DevOps

1. Use o projeto Dev2Prd que já existe no Azure DevOps.
2. Em Repos, crie um repositório novo knowledge (separado do repo da esteira de vídeo) e envie o conteúdo desta pasta (git init, git add ., git commit, git push).
3. Em Overview > Wiki, escolha Publish code as wiki, aponte para o repo knowledge, branch main, pasta /.
4. A página inicial é index.md. Hífens nos nomes de arquivo viram espaços no título da wiki.

Abrir no Obsidian

1. Clone o mesmo repositório no seu computador.
2. No Obsidian, Open folder as vault e escolha a pasta clonada.
3. Instale o plugin da comunidade Git (Vinzent03/obsidian-git) para fazer commit e push direto do Obsidian.
4. Abra o Graph view: cada tópico é um ponto, as setas são “depende de”, e as cores vêm da nota:
   • verde: 4,5 a 5
   • azul: 3,5 a 4
   • laranja: 2,5 a 3
   • vermelho: 0 a 2
   • roxo: categorias

Regras para os dois funcionarem juntos

• Use links Markdown normais [texto](caminho.md), não [[wikilinks]]. O vault já vem configurado assim, e o Azure DevOps não entende [[ ]].
• Nomes de arquivo sem acento e sem espaço (use hífen). O título com acento vai no # Título da página.
• A nota fica no campo rating: do topo da página. Ao mudar, adicione uma linha em “Histórico da nota”.

Como atualizar uma nota

1. Abra a página do tópico.
2. Mude rating: no topo e a linha Nota logo abaixo do título.
3. Adicione uma linha no Histórico com data, nota nova e o motivo (curso, projeto, vídeo gravado).
4. Commit. O git guarda quando cada nota mudou.

Estrutura

• knowledge/: mapa de skills, público em kb.jimmyblizz.com.
• dev2prd/: estrutura do canal, com login (mesmo oauth2-proxy do cockpit) em kb.jimmyblizz.com/dev2prd/.

Publicar o site (Quartz)

São dois builds do mesmo vault, para a busca e o grafo do site público não incluírem nada de dev2prd/:

1. Build público: Quartz com ignorePatterns incluindo dev2prd, servido em kb.jimmyblizz.com.
2. Build privado: só dev2prd/, servido em kb.jimmyblizz.com/dev2prd/ atrás do oauth2-proxy.