certo? Alem do mais, voce nao precisa se deslocar ate a definicao/implementacao/declaracao do identificador para obter maiores detalhes, o que quase sempre resulta na interrupcao da linha de raciocinio durante alguma investigacao.Uma outra vantagem que notei sobre a utilizacao do Help Insigh e poder ter dois tipos de documentacao a respeito de um metodo sobre dois pontos de vista.Deixa eu exemplificar. Observe o codigo fonte abaixo.unit Unit1;interfaceuses Windows, Messages, SysUtils, Variants, Classes, Graphics, Controls, Forms, Dialogs;type TForm1 = class(TForm) private { Private declarations } protected function FieldIsModified(var FieldComp: TFieldItem; const Index: Integer; out Modified: Boolean): Boolean; virtual; public end;var Form1: TForm1;implementation{$R *.dfm}{ TForm1 }{_/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\ Definition.: Protected Strict [ ] Virtual/Override [X] Event [ ] Ojective...: Usefulness.: Parameters.: [ I ] FieldComp = [ I ] Index = [ O ] Modified = Result.....: Comments...:_/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\__/-\}function TForm1.FieldIsModified(var FieldComp: TFieldItem; const Index: Integer; out Modified: Boolean): Boolean;begin // ...end;end. Creio que a pratica mais comum de documentacao de codigo seja a inclusao de comentarios imediatamente acima da implementacao dos metodos/funcoes (como apresentando no exemplo acima), ficando a area de interface da unit com apenas as definicoes.O codigo fonte acima contem a estrutura do bloco de comentario que costumo utilizar para documentar um metodo ou uma function (removi o texto para ficar mais facil sua visualizacao). As informacoes que acrescento nesse bloco estao relacionadas principalmente com seu funcionamento, com sua dependencia perante a solucao como um todo e com cuidados que devem ser tomados na sua utilizacao.Quando penso no Help Inside, penso em um ponto de vista onde saber como e o funcionamento interno de um metodo nao e tao importante, naquele momento, quanto saber o que o metodo faz, suas entradas e suas saidas. Assim, quando digo que o Help Insight proporciona um segundo tipo de comentarios e justamente a possibilidade de documentar o codigo fonte sob uma perspectiva mais focada no conceito do que em detalhes intrinsecos ao funcionamento.Apesar de muito util, fique um tanto desconfortavel com relacao a legibilidade (ou melhor, a falta de legibilidade) que a estrutura de definicao das tags causa ao layout da classe.Por exemplo, se voce possui um classe com varios metodos e propriedades. Acrescentar um help insigh para cada definicao ira dinimuir a visao do todo por exigir constante deslocamento entre as linhas para navegar pela classe (aqui o layout struct do Delphi se mostrou ainda mais util).Fiz alguns testes e notei que o IDE aceita a utilizacao de REGIONS para delimitar a area do Help Insight, o que pareceu uma forma bem razoavel para resolver ou, no minimo, minimizar a area visivel ocupada.Um segundo ponto com relacao a legibilidade e que nao ha uma formatacao especifica para as tags. a) E possivel escrever a descricao de uma tag utilizando multi-linhas ou em apenas uma unica linha que o conteudo sera apresentado igualmente no popup; b) Pode-se acrescentar espacos varios espacos em brancos, mas os excedentes serao ignorados (assim como em HTML); c) Qualquer quebra de linha sera ignorada, o que da margem para formatar melhor o texto na unit, mas na hora de exibir o popup, as