Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Feature Request] Documentação dos fontes no código pra facilitar uso. #146

Open
mobius1qwe opened this issue Nov 17, 2022 · 3 comments
Milestone

Comments

@mobius1qwe
Copy link
Contributor

Descrição da sugestão
Documentar brevemente o que as funções fazem no fonte através de comentários na assinatura dos métodos, por exemplo:

// Método que dispara uma mensagem após clicar no botão
procedure ButtonClick(Sender: TObject);
begin
  showmessage('blah');
end;

Motivo da Mudança
Dessa forma a documentação consegue ser automatizada e facilita o entendimento do usuário que for ler o código.

@mobius1qwe mobius1qwe added this to the 2.+ milestone Nov 17, 2022
@joseh-henrique
Copy link

Caso a função/procedure tenha históricos de problemas, onde determinado parâmetro causa determinado efeito, tem que ser informado. Resumindo não apenas informando para que serve, mas o conjunto todo, função/procedure e seus parâmetros.

@mobius1qwe
Copy link
Contributor Author

Caso a função/procedure tenha históricos de problemas, onde determinado parâmetro causa determinado efeito, tem que ser informado. Resumindo não apenas informando para que serve, mas o conjunto todo, função/procedure e seus parâmetros.

Se quiser contribuir só fazer um PR que será muito bem aceito!

@joseh-henrique
Copy link

joseh-henrique commented Nov 17, 2022 via email

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Status: Todo
Development

No branches or pull requests

2 participants