Quais obstáculos enfrentam o processo de desenvolvimento no uso de linguagens de marcação de texto sem formatação, em oposição a, por exemplo, Microsoft Word? [fechadas]

Atualmente, sou estagiário em uma empresa contratada pelo governo e estou tendo a sensação (irritantemente inevitável) de que o Word é o padrão de fato no processo de desenvolvimento de software.

Seu formato binário dificulta muito a colaboração em documentos da maneira como estou acostumado a colaborar em uma base de código. O uso da marcação de texto sem formatação (com idiomas como LaTeX, Markdown, ReStructured Text, etc. ) permite um documento de fácil compreensão que funciona bem com o fluxo de trabalho normal de um desenvolvedor. Quanto aos comentários em que o idioma não os suporta (por exemplo, Markdown), existem muitas soluções existentes que permitem comentários colaborativos em bases de código (por exemplo, GitHub, Bitbucket) que podem ser facilmente aplicadas a outros arquivos de texto sem formatação que contenham marcação.

Entendo que a necessidade de cooperar com o gerenciamento tecnologicamente analfabeto exige algum tipo de interface gráfica para tudo, mas essas interfaces existem para a maioria desses formatos. Por exemplo, o LaTeX possui um tipo de "garfo" chamado LyX que coloca um front-end gráfico em uma sintaxe de texto simples, semelhante ao LaTeX. Este arquivo, embora principalmente gráfico em sua edição, ainda é fácil de usar. (Ele também possui comentários no estilo do Word.) Muitas dessas soluções ainda podem ser usadas no lugar do Word, e a grande maioria é gratuita ou de código aberto.

No entanto, usamos o Word mesmo para nossa própria documentação interna que ninguém mais vê. Trabalhamos com texto para uma parte significativa da nossa carreira - por que a documentação é tão especial? Além do trivial "Não sabíamos melhor e agora estamos presos aqui", deve haver razões para apoiar essa decisão. Quais são os desafios enfrentados pelo processo de desenvolvimento de software no uso da documentação em texto simples em vez de outros meios mais coloquiais (e debativelmente menos poderosos) de escrever documentos?

Como os motivos serão diferentes, talvez seja necessário responder a esses dois cenários intimamente relacionados separadamente.

• Usando documentação em texto sem formatação desde o início
• Migrando para documentação em texto sem formatação ao longo do tempo

Muitos participantes no processo de desenvolvimento de software não são desenvolvedores e precisam da capacidade de interagir com a documentação independentemente. O controle de qualidade / marketing deve usar o word e os desenvolvedores usam algo completamente diferente? Seria inconsistente, acrescentaria outra ferramenta à cadeia de manutenção e a parte de TI de uma empresa pode não ter idéia do que fazer com os arquivos, quando souberem perfeitamente como gerenciar / manter um repositório de documentos do Word.

Acima de tudo, muitos não desenvolvedores passaram anos na universidade usando o Microsoft Word para entregar seus trabalhos, frequentemente tendo tido aulas de treinamento reais sobre como usar o word. Eles sabem disso muito melhor do que alternativas. Eu mal posso dizer a diferença quando estou trabalhando no Open Office vs Word, mas quando minha cunhada a usou para economizar dinheiro, uma semana depois, ela pediu ao marido que comprasse a palavra e proclamou "Desde que recebi a palavra eu amo meu novo laptop! ". Pense na mentalidade que confunde coisas assim, uma ligeira mudança no que elas estão acostumadas não é 'leve' para elas.

A palavra moderna permite diferenças de versão, anotações com rastreamento de versão e mesclagem de alterações também. Pode não ser tão simples quanto a mesclagem de códigos, mas já vi muitos gerentes de projeto fazerem isso facilmente, portanto, certamente os desenvolvedores também podem fazê-lo.

Além disso, tornou-se bastante comum entre as equipes de desenvolvimento fazer documentação nas wikis, porque ela volta à representação textual enquanto permanece simples o suficiente para que não-desenvolvedores possam fazer edições.

Pessoalmente, acho que é uma questão de educação.

A maioria das pessoas foi levada a pensar que o uso de uma ferramenta como o MS Word facilita a produção de documentos de qualidade, mas, pelo que vi, na verdade, fica mais difícil. Você acaba depurando a formatação sem parar e luta com suas ferramentas para obter o resultado desejado.

Ferramentas como o Scrivener permitem que você se aproxime um pouco da realidade do documento sem precisar lutar contra isso como você faz com o Word. Em parte devido à realização do WYSIWYG, na verdade, não funciona muito bem.

Na minha própria organização, quanto mais pessoas passarem a usar o MarkDown para a maioria dos documentos, mais pessoas serão mais felizes e produtivas.

Você realmente tem 2 perguntas:

Primeiro: Por que grupos que não são de desenvolvimento não usam LaTeX ou outro Markdown no processo de desenvolvimento de software?

O problema da migração para o LaTeX é a curva de aprendizado percebida, principalmente quando você lida com usuários não técnicos. Os usuários já conhecem outros formatos e não querem aprender outro método para fazer a mesma coisa que estão fazendo. Eles sabem pouco ou nada sobre como diferenciar 2 documentos e, portanto, há pouco valor em mudar para um formato baseado em texto para eles. Explicar a uma pessoa que você tem uma solução para um problema que ela não sabia que tinha é uma venda bastante difícil.

Você também não pode subestimar o valor do impulso para a frente. Para migrar para um novo formato, você realmente precisa convencer outras pessoas da sua cadeia, vale a pena investir em aprender algo novo. Mesmo que você não espere que eles editem nada, leva tempo e muito esforço para migrar para um novo formato quando um formato existente funciona (mesmo que seja ruim).

A segunda pergunta: Por que minha equipe continua a usar documentos do Word quando existem melhores opções e são mais capazes de aprendê-los?

É algo sobre o qual você deve conversar com as pessoas da sua equipe. Pode haver razões válidas para que eles optem por manter documentos do Word ou apenas porque é assim que sempre foi feito.

Existem custos associados a qualquer alteração e pode ser caro e demorado mover centenas ou milhares de documentos para um novo formato. Se você vai tentar mudar seu ambiente, espere ter que argumentar por que você deve mudar