Eu tenho configurado o Apache e o PHP, e os arquivos de configuração padrão têm uma tonelada de opções comentadas, muitas das quais eu duvido que usarei.
Depois de salvar o arquivo padrão como um backup e ajustar minha configuração para a perfeição, pensei em passar e excluir a maioria das linhas comentadas, para tornar meus arquivos de configuração mais curtos e legíveis.
Qual é a sabedoria convencional sobre isso?
Se eu começar com a configuração padrão, geralmente deixo-os entrar. Se eu quiser uma configuração mais limpa, que geralmente é muito mais fácil de ler, eu renomeio a configuração padrão e construo uma nova do zero. Dessa forma, eu ainda posso ver os comentários originais se mais tarde eu precisar adicionar algumas funções ou recursos.
Pessoalmente, deixo-os entrar. Na maioria das vezes, as diretivas comentadas têm seus padrões explicitamente especificados, além de uma breve descrição do objetivo e dos possíveis valores para o campo. Faz com que encontrar as palavras certas para pesquisas no google muito mais rápido às vezes.
Em geral, minha teoria é que eventualmente eu os colocarei em um controle de revisão de algum tipo para que eu possa fazer as diferenças entre o que está sendo executado e o que veio com o sistema para que eu possa ver rapidamente o que eu mudei.
Eu apago as coisas que não preciso; é uma distração e irritante. Eu, por outro lado, comentarei liberalmente meus arquivos de configuração com a intenção da minha configuração, e também links para documentação interna e upstream relativa à configuração (a referência autoritativa para as diretivas de arquivo de configuração, e qualquer documentos de design que poderíamos ter sobre a máquina em questão).
Faça uma cópia do original e chame-o de program.conf.orig ou .default, depois retire os comentários usando egrep -v "^ # | ^ $" program.conf.orig > program.conf e você fica com a configuração atual. Se eu precisar fazer referência a comentários na configuração original, eu a tenho lá. Esse arquivo também entra em um sistema de controle de versão (escolha seu veneno)
Tags configuration