Documentos, concorrência e referências

1. Define que informação precisa de controlo

Uma pasta comum não define, por si só, como se controla informação de requisitos. Identifica os objetos que sustentam decisões: requisito, modelo, exemplo, decisão e referência aprovada podem ter relações diferentes. Define identidade, responsável, estados e forma de localizar a versão aplicável a um contexto.

Isso não obriga a guardar cada frase como documento independente. Num exercício, uma especificação tem revisão, consumidores abrangidos e data de aplicação; uma proposta de alteração aponta para a revisão de partida e descreve o efeito pretendido.

O leitor deve distinguir o conteúdo que pode usar hoje daquele que está a ser preparado. Planeia também quem pode editar, rever e publicar, porque permissão técnica de escrita não equivale a mandato de aprovação. Começa pelas perguntas que o controlo deve responder e escolhe ferramentas que permitam fazê-lo com manutenção razoável.

A quantidade de campos, isoladamente, não mede a qualidade da governação.

2. Evita perder alterações feitas em paralelo

Duas pessoas podem editar cópias da mesma revisão. No exemplo, V4 define retenção de sete dias e tempo limite de vinte segundos. Ana aprova e publica V5 com retenção de trinta dias.

Bruno preparou sobre V4 uma proposta para tempo limite de dez segundos, sem intenção de alterar retenção. Substituir V5 pela cópia inteira de Bruno faria regressar retenção a sete. Planeia comparação entre base, versão atual e proposta: conserva a alteração de retenção já aplicável e avalia a alteração do tempo limite pelo processo definido.

Se ambos alteraram a mesma condição de forma incompatível, é necessário resolver o conflito de significado. Mesmo sem conflito textual, duas alterações podem interagir, pelo que uma fusão técnica não demonstra consistência dos requisitos. O plano deve identificar quem revê o resultado e como se regista a base usada.

Não suponhas que todas as ferramentas detetam ou resolvem estas situações automaticamente.

3. Controla equivalência entre idiomas

Num projeto internacional, duas versões linguísticas podem parecer equivalentes sem o serem. “Até dois segundos” e “pelo menos dois segundos” impõem condições diferentes. No processo fictício, a versão inglesa aprovada é referência contratual; a tradução portuguesa facilita a utilização e precisa de revisão de equivalência antes de ser publicada como tradução controlada.

Se uma diferença for detetada, conserva a referência inglesa aplicável, identifica a tradução como não válida para aquele uso e corrige-a pela via acordada. Não apresentes ambas como alternativas igualmente aprovadas. Esta regra pertence ao exercício; outros projetos podem exigir duas versões com igual autoridade.

O plano deve declarar a relação, o revisor competente e o tratamento de diferenças. A revisão deve olhar para condições, unidades, negações e âmbito, além do estilo. Uma tradução fluente que altera uma condição de aceitação não é apenas uma preferência linguística.

4. Publica para o contexto e a data certos

Uma revisão aprovada hoje pode aplicar-se apenas à próxima release. Num exercício, V8 vale para a release atual e V9 foi aprovada para uma release futura ainda não instalada. A página “instrução em produção” deve continuar a resolver para V8 enquanto essa for a associação válida.

V9 pode estar disponível para preparação, claramente identificada. A alteração do apontador de consulta precisa de acompanhar a regra de aplicação definida, sem apagar histórico. Uma ligação estável facilita acesso, mas não deve esconder qual revisão foi efetivamente usada numa decisão anterior.

Conserva essa referência específica quando a evidência depende dela. Um resumo ou exportação também precisa de permitir reconhecer origem, versão e limites relevantes. Um ficheiro com data mais recente pode ser uma cópia de informação antiga; data de descarga não prova atualidade.

Planeia publicação e consulta de forma que um operador consiga encontrar a instrução válida para o sistema que realmente está a operar.

5. Planeia acesso suficiente para rever

Um revisor incluído na lista de distribuição pode não ter acesso ao material necessário. No exemplo, a ligação abre apenas o resumo, mas a decisão exige confirmar três condições disponíveis num anexo autorizado. A presença na reunião ou a abertura do resumo não demonstram revisão dessas condições.

Planeia acesso compatível com a função e a informação necessária antes de pedir decisão. Se existirem restrições, prepara uma forma autorizada de fornecer evidência suficiente, como uma vista controlada com os campos relevantes. Não pressuponhas que enviar qualquer cópia para um canal pessoal resolve o problema.

Também não exijas o arquivo inteiro se a decisão pode ser sustentada pela informação apropriada e permitida. Define como o revisor indica material indisponível, que efeito isso tem no estado e quem resolve o acesso. O objetivo é permitir uma revisão real dentro das condições aplicáveis, com uma referência que continue recuperável depois da reunião.

6. Oficina: revisão paralela e publicação

Prepara uma decisão de tratamento para estes registos fictícios: base V4 com retenção de sete dias e tempo limite de vinte segundos; atual V5 com retenção aprovada de trinta dias; proposta P6, criada de V4, que pretende mudar apenas tempo limite para dez segundos.

Existe ainda uma tradução de V5 que diz sete dias. Resolução: comparar a proposta com a sua base para identificar a intenção; conservar trinta dias ao integrar a mudança de tempo limite, que continua a precisar da análise e decisão previstas.

A tradução não está equivalente a V5 e deve ser corrigida antes de ser apresentada como tradução controlada. Regista que revisão serviu de base e qual resultado foi revisto. Se a proposta for aprovada para uma release futura, mantém a referência de produção associada à release atual até se cumprir a regra de aplicação.

Uma comparação de ficheiros pode revelar diferenças, mas não decide autoridade, equivalência semântica ou prontidão. Acrescenta um teste de leitura: outro participante consegue identificar a instrução válida para hoje e a proposta para amanhã?

7. Calcular efeitos que atravessam alterações diferentes

Uma fusão sem conflito de texto pode produzir um comportamento que nenhum autor avaliou isoladamente. Identifica primeiro o contrato que relaciona os campos. Num modelo didático independente, há três tentativas, incluindo a inicial em t=0, com intervalo de 20 segundos.

O limite é de três inícios na primeira janela [0, 60), que inclui zero e exclui 60. Os inícios são 0, 20 e 40. Aumentar apenas o total para cinco mantém três inícios nessa janela: 0, 20 e 40, ficando 60 e 80 de fora.

Reduzir apenas o intervalo para 15 também mantém três: 0, 15 e 30. Porém, combinar cinco tentativas com intervalo de 15 produz 0, 15, 30, 45 e 60; agora quatro inícios pertencem à janela. As alterações podem estar em linhas diferentes e continuar a interagir.

Escreve os instantes antes de contar, confirma se o limite inclui o instante final e distingue número total de tentativas, duração e quantidade dentro da janela. Se existir outro limite para a última tentativa, verifica-o separadamente. Usa a análise conjunta para preparar alternativas e a decisão competente; não a confundas com autorização de publicação ou prova de recuperação real.

Estes números são premissas de um exercício, não uma política recomendada para qualquer serviço.

Rever relações além dos campos alterados

Uma base define uma tentativa com limite de 15 segundos. A versão atual aprova três tentativas de 15; o percurso tem limite obrigatório de 50 segundos. Uma proposta criada sobre a base aumenta só o limite por tentativa para 20. A base proposta usa 20 segundos e a versão atual usa 45; ambas cabem em 50 quando consideradas isoladamente. A junção automática produz três tentativas de 20, ou 60 segundos, e falha. Constrói a comparação base–atual–proposta e identifica a relação que o editor de texto não avaliou.

A resposta adequada não é apagar a proposta nem aceitar a junção por os campos diferirem. Conserva a versão aprovada e prepara a decisão sobre o impacto conjunto. Reduzir tentativas, reduzir o limite ou rever o objetivo podem ser alternativas com consequências diferentes; nenhuma herda autorização só por passar a conta. No trabalho, mantém referências às decisões que originaram cada campo e às restrições que ligam campos distintos. Usa exemplos de pior duração permitida quando o requisito é um limite máximo. Regista também o que a proposta não pretendia alterar. Resumo: uma fusão textual sem conflito pode produzir um comportamento incompatível; o controlo documental precisa de análise semântica e de decisão explícita.

Armadilhas comuns

Última gravação como decisão válida; fusão textual como coerência; tradução fluente como equivalente; data de descarga como versão atual.