Guia de estilo MedCards 2027.1 (rascunho do alfa)
Este guia vale para todos os decks compartilhados. Os ids das seções (E-1 a E-13) são estáveis: as regras de lint, os códigos de motivo e o treinamento de revisores citam esses ids.
E-1 Princípios
E-1.1 Uma informação por card (princípio da informação mínima).
E-1.2 Dê contexto no enunciado: população, cenário e tema.
E-1.3 Prefira evocação a reconhecimento.
E-2 Tipos de nota
E-2.1 Use Básico para um fato isolado, Cloze para fatos dentro de uma frase e Caso clínico para raciocínio.
E-2.2 Use Droga, Doença, Valor laboratorial, Oclusão de imagem e Mnemônico quando o conteúdo tiver essa forma.
E-3 Cloze
E-3.1 A frase do cloze tem até 25 palavras e o cloze tem até 5 palavras.
E-3.2 Até 4 números de cloze por nota; não aninhe clozes em mais de 2 níveis.
E-3.3 Sem pistas gramaticais: o artigo e a concordância antes da lacuna entram na lacuna.
E-3.4 A lacuna esconde o termo-chave, nunca uma palavra vazia.
E-4 Respostas
E-4.1 Respostas de Básico com até 12 palavras; o resto vai para o Extra.
E-4.2 Listas com até 5 itens; acima disso, divida ou use um mnemônico.
E-4.3 Sem "todas as alternativas", sem dupla negação e sem perguntas de sim ou não.
E-4.4 O verso de um card reverso é curto e sem ambiguidade.
E-5 Língua
E-5.1 Norma culta do português do Brasil; nomes de fármacos pela DCB.
E-5.2 Abreviaturas da lista aprovada, por extenso uma vez no Extra; evite as formas da lista "não use" do ISMP.
E-5.3 Epônimo com o nome descritivo.
E-5.4 O texto está na língua da nota.
E-6 Números e doses
E-6.1 Todo número tem unidade.
E-6.2 Dose com via, frequência e população (adulto, pediatria, gestante).
E-6.3 Vírgula decimal no texto em português; ponto no texto em inglês.
E-6.4 Marque a jurisdição quando Brasil e EUA diferem.
E-6.5 Data em fatos voláteis.
E-7 Formatação
E-7.1 Negrito no sujeito principal; sem ponto final em fragmentos.
E-7.2 Tabelas só no Extra; cores da paleta semântica, nunca cores livres.
E-7.3 Fórmulas em TeX que renderizam; links HTTPS.
E-8 Fontes
E-8.1 Toda nota compartilhada tem fonte; dose e limiar têm fonte na mesma nota.
E-8.2 Formatos: Vancouver/NLM para artigos; "SBC. Diretriz … 2025, seção 4.2"; PCDT com portaria e data; livro com edição e página.
E-8.3 Só edições atuais, com o ano da diretriz e o localizador.
E-9 Imagens
E-9.1 Licença permitida e crédito "Autor, título, licença, fonte, alterações".
E-9.2 Largura de 500 a 1.600 px; imagem diagnóstica com o lado menor de 600 px ou mais.
E-9.3 Texto alternativo em toda imagem que informa; sem imagens decorativas.
E-9.4 Sem dados de pacientes; sem imagens médicas geradas por IA.
E-9.5 Oclusão: rótulos em todas as máscaras, sem sobreposição, até 20 máscaras por imagem.
E-10 Prova vs prática
E-10.1 Quando a resposta da prova difere da prática atual, a nota diz as duas, com a fonte de cada uma.
E-11 Nota de atualização
E-11.1 "Atualizado em MM/AAAA: <resumo> (<fonte>)" no topo do Extra por 12 meses.
E-12 Linguagem respeitosa
E-12.1 Linguagem inclusiva; sem estereótipos em casos clínicos; sem mnemônicos ofensivos.
E-13 Jurisprudência
E-13.1 As decisões das reuniões mensais de calibração ficam aqui, com data e exemplos.
E-13.2 Duplicatas: a nota mais antiga e mais completa fica; a outra se funde a ela.
E-13.3 Conteúdo de IA só entra depois que uma pessoa o aceita.