* by MessagePosters that require one, unless the message already contains the string
* ~~~.
* @return {jQuery.Promise} Promise completing when the post succeeds or fails.
- * @return {Function} return.done
- * @return {Function} return.fail
- * @return {string} return.fail.primaryError Primary error code. For a mw.Api failure,
- * this should be 'api-fail'.
- * @return {string} return.fail.secondaryError Secondary error code. For a mw.Api failure,
- * this, should be mw.Api's code, e.g. 'http', 'ok-but-empty', or the error passed through
- * from the server.
- * @return {Mixed} return.fail.details Further details about the error
+ * For failure, will be rejected with three arguments:
+ *
+ * - primaryError - Primary error code. For a mw.Api failure,
+ * this should be 'api-fail'.
+ * - secondaryError - Secondary error code. For a mw.Api failure,
+ * this, should be mw.Api's code, e.g. 'http', 'ok-but-empty', or the error passed through
+ * from the server.
+ * - details - Further details about the error
*
* @localdoc
* The base class currently does nothing, but could be used for shared analytics or
* API and ResourceLoader requests in the background.
*
* @param {mw.Title} title Title that will be posted to
- * @return {jQuery.Promise} Promise for the MessagePoster
- * @return {Function} return.done Called if MessagePoster is retrieved
- * @return {mw.messagePoster.MessagePoster} return.done.poster MessagePoster
- * @return {Function} return.fail Called if MessagePoster could not be constructed
- * @return {string} return.fail.errorCode String error code
+ * @return {jQuery.Promise} Promise resolving to a mw.messagePoster.MessagePoster.
+ * For failure, rejected with up to three arguments:
+ *
+ * - errorCode Error code string
+ * - error Error explanation
+ * - details Further error details
*/
MwMessagePosterFactory.prototype.create = function ( title ) {
var pageId, page, contentModel, moduleName,