//создаем комментарий, и заполняем его свойства 
var comment = PublicAPI.Portal.Objects.Common.Comment.Create();
comment.CreationAuthor = PublicAPI.Portal.Security.User.GetCurrentUser();
comment.CreationDate = DateTime.Now;
comment.Text = "Комментарий";


//загружаем документ по идентификатору 
var document = PublicAPI.Docflow.Document.LoadOrNull(23);


//Добавляем комментарий
PublicAPI.Docflow.Document.AddComment(document, comment);


//ВНИМАНИЕ!! За одну транзакцию вы можете добавить только ОДИН комментарий к документу 
//Пример:
comment.Text = "Комментарий, который добавится";
PublicAPI.Docflow.Document.AddComment(doc, comment, commentAuthor); //данный комментарий добавится
comment.Text = "Комментарий, который не добавится";
PublicAPI.Docflow.Document.AddComment(doc, comment, commentAuthor); //данный комментарий не добавится