Comment api

[crnfpp]

No description provided.

[netlify]

❌ Deploy Preview for moodledevdocs failed.

Built without sensitive environment variables

Name	Link
🔨 Latest commit	4e733bd
🔍 Latest deploy log	https://app.netlify.com/sites/moodledevdocs/deploys/650848af28e88700080a72d9

[andrewnicols]

Just a few minor changes and we can land this. I'm sure we'll improve the docs in future. This API is long overdue a complete rewrite. It's a horrific API to work with!

[andrewnicols]

Slugs don't have a trailing /

Suggested change

	slug: "/docs/apis/core/comment/"
	slug: "/docs/apis/core/comment"

[andrewnicols]

Relative links should be to a file, and this should link to apis not api.

Suggested change

	The [Comment API](./api/core/comment) allows you to save and retrieve user comments, so that you can easily add commenting to any of your code.
	The [Comment API](./apis/core/comment/index.md) allows you to save and retrieve user comments, so that you can easily add commenting to any of your code.

[andrewnicols]

When migrating docs, we try to update to meet current coding style:

Suggested change

	```php
	$cmt = new stdclass;
	$cmt->contextid = $modcontext->id;
	$cmt->area = 'format_post';
	$cmt->itemid = $post->id;
	$options->comments = $cmt;
	echo format_text($post->message, $post->messageformat, $options, $course->id)."<hr />";
	```
	```php
	$cmt = new stdClass();
	$cmt->contextid = $modcontext->id;
	$cmt->area = 'format_post';
	$cmt->itemid = $post->id;
	$options->comments = $cmt;
	echo format_text($post->message, $post->messageformat, $options, $course->id) . "<hr />";

[andrewnicols]

Suggested change

	$options->area = 'database_entry';
	$options->context = $context;
	$options->itemid = $record->id;
	$options->component = 'mod_data';
	$options->showcount = true;
	$comment = new comment($options);
	$comment->output(false);
	$options->area = 'database_entry';
	$options->context = $context;
	$options->itemid = $record->id;
	$options->component = 'mod_data';
	$options->showcount = true;
	$comment = new comment($options);
	$comment->output(false);

[sarjona]

HI @crnfpp!
Is there any chance you can look at and fix the points raised by Andrew? If you can't, let us know and we'll try to reassign it :-)