Basicamente você quer abrir seus projetos de scripts para o mundo open source, oque é muito louco, e não, não acho que precise fazer uma documentação descrevendo o código, ou explicando partes, apenas as que considera mais "fora da curva", em algum sentido. Por quê? Bom, no meu ponto de vista, principalmente se tratando de contribuição de terceiros, você quer que entendam o máximo do seu código, com apenas explicação de contexto/projeto, não de código, já que pra contribuirem ou melhorarem, eles precisam ter conhecimento do código que ta sendo aplicado. Você não precisa documentar seu código, só o projeto. Ou seja, o que seu script faz, por que fez ele, e talvez algum detalhe bem especifico da implementação(código). De resto, acredito que seja sempre melhor, que as pessoas quando olharem ou usarem seu script, achem coisas a serem feitas ou melhoradas, e consigam se encontrar no código, para de desenvolver.

E a, quando postar algo no github, e abrir pra PRs, me manda aqui, pra ver se eu consigo ajudar com algo