Renomear Conceptual.md para README.md não tem mistério e poderia encerrar por aqui. A dificuldade que poderia permanecer, apesar do nome dos arquivos indicar a sua funcionaldade, é: "Exatamente o que faz String.pas?"

A minha ideia seria, para cada fragmento, incluir uma linha no formato (e.g. Pascal):

[String.pas] : Por que Shortstring consome mais memória do que uma String comum? - [delphi]

• nome do programa com link para o fonte
• descrição (pergunta no Stackoverflow)
• link para a página (https://pt.stackoverflow.com/q/205885/101)

A inclusão de novos fragmentos seriam feitas normalmente e só rodar o programa/script para gerar o arquivo novamente.

O resultado final do README.md para Pascal ficaria (nomenclatura e formato TBD):

Conceitos

• Delphi é uma IDE ou linguagem de programação?
• O Delphi possui coletor de lixo?
• Que tipo de variável aloca menos memória, integer ou string?
• Enviar mensagem para TV conectada na rede
• O uso do Try no Delphi quando mal usado pode ser uma armadilha?
• Comparação de variáveis de tipo diferente com conversão retorna resultado incorreto

Exemplos

• QueryBuilder.pas : Montando updates em tempo de execução - java
• Power.pas : Como usar expoente em Pascal? - matemática
• String.pas : Por que Shortstring consome mais memória do que uma String comum? - delphi
• StringInArray.pas : Descobrir se item está em array - delphi

from sopt.

Gostei e vou adotar sim.

Eu não sei se entendi bem o item 3, pode desenvolver mais? Não sei se precisa de algo para automatizar, mas estou aberto para escutar sobre isso. Pode ser que não esteja claro o que são as postagens conceituais.

Sempre que eu tenho código na minha resposta, eu coloco aqui e tem um link para a resposta. Quando não tem código eu coloco no conceptual.md, assim passa ter link para resposta e daqui a pessoa pode achar conteúdo relevante. Nem tudo eu trago pra cá, precisa ter tido certa visibilidade e o assunto ser interessante. Se tiver código vem tudo.

Eu não sabia que este repositório teria o sucesso que teve :D Fiz pra me ajudar em um ponto, não fiz para os outros :D A vida nos surpreende.

Muito obrigado.

from sopt.

Dá uma olhada. Eu fiz o que deu. Por requisitos não pude mexer tanto.

Eu ainda não sei se vale a pena linkar descrições para cada arquivo com código. Mas o tempo pode mudar isso e com mais sucesso eu resolver fazê-lo.

Se ainda tiver algo que possa ajudar estou ansioso por saber de você.

Muito obrigado por sua contribuição.

from sopt.