docs: fix and improve documentation

Author: jakubbortlik

doc/gitlab.nvim.txt

@@ -938,8 +938,8 @@ drafts, and regular (or live) mode, where comments are posted immediately.
 gitlab.toggle_sort_method() ~
 
 Toggles whether the discussion tree is sorted by the "latest_reply", with
-threads with the most recent activity on top, or by "original_comment", with
-the oldest threads on top.
+threads with the most recent activity on top (the default), or by
+"original_comment", with the oldest threads on top.
 
                                                                 *gitlab.nvim.add_assignee*
 gitlab.add_assignee() ~

lua/gitlab/actions/discussions/init.lua

@@ -805,7 +805,8 @@ M.toggle_draft_mode = function()
   winbar.update_winbar()
 end
 
----Toggle between draft mode (comments posted as drafts) and live mode (comments are posted immediately)
+---Toggle between sorting by "original comment" (oldest at the top) or "latest reply" (newest at the
+---top).
 M.toggle_sort_method = function()
   if state.settings.discussion_tree.sort_by == "original_comment" then
     state.settings.discussion_tree.sort_by = "latest_reply"