'Set a suggested sort for a link.
Suggested sorts are useful to display comments in a certain preferred way
for posts. For example, casual conversation may be better sorted by new
by default, or AMAs may be sorted by Q&A. A sort of an empty string
clears the default sort.'

@require_oauth2_scope('modposts')
@validatedForm(VUser(), VModhash(), VSrCanBan('id'), thing=VByName('id', thing_cls=Link), sort=VOneOf('sort', CommentSortMenu.suggested_sort_options), timeout=VNotInTimeout('id'))
@api_doc(api_section.links_and_comments)
def POST_set_suggested_sort(self, form, jquery, thing, sort, timeout):

    if (c.user._id != thing.author_id):
        ModAction.create(thing.subreddit_slow, c.user, target=thing, action='setsuggestedsort')
    thing.suggested_sort = sort
    thing._commit()
    jquery.refresh()
