diff --git a/src/components/AdminSettings.vue b/src/components/AdminSettings.vue index 881b57d272..f8922b57dd 100644 --- a/src/components/AdminSettings.vue +++ b/src/components/AdminSettings.vue @@ -121,7 +121,7 @@ import { confirmPassword } from '@nextcloud/password-confirmation' * Debounce helper for method * TODO: Should we remove this and use library? * - * @param {function()} func - The callback function + * @param {Function} func - The callback function * @param {number} wait - Time to wait in miliseconds */ function debounce(func, wait) { diff --git a/src/components/ContentTemplate.vue b/src/components/ContentTemplate.vue index 9d42e56b8f..57a1ce618d 100644 --- a/src/components/ContentTemplate.vue +++ b/src/components/ContentTemplate.vue @@ -80,6 +80,10 @@ watch(selectedFeedItem, (newSelectedFeedItem) => { } }) +/** + * Unselect a list item. + * + */ function unselectItem() { itemStore.mutations.SET_SELECTED_ITEM( itemStore.state, diff --git a/src/components/ShareItem.vue b/src/components/ShareItem.vue index 195f129bef..e106ebcc95 100644 --- a/src/components/ShareItem.vue +++ b/src/components/ShareItem.vue @@ -95,7 +95,7 @@ export default Vue.extend({ /** * Adds or removes user to selected list * - * @param user {ShareUser} user that was clicked + * @param {ShareUser} user - User that was clicked */ clickUser(user: ShareUser) { const selectedUsers = this.selected.map((val: ShareUser) => { return val.shareName }) diff --git a/src/components/feed-display/FeedItemDisplay.vue b/src/components/feed-display/FeedItemDisplay.vue index e8fe51aba0..cb9becdbc3 100644 --- a/src/components/feed-display/FeedItemDisplay.vue +++ b/src/components/feed-display/FeedItemDisplay.vue @@ -85,9 +85,11 @@ +
+
diff --git a/src/components/feed-display/FeedItemRow.vue b/src/components/feed-display/FeedItemRow.vue index 13420e7124..c202a1e28e 100644 --- a/src/components/feed-display/FeedItemRow.vue +++ b/src/components/feed-display/FeedItemRow.vue @@ -23,7 +23,9 @@
+ +
diff --git a/src/dataservices/feed.service.ts b/src/dataservices/feed.service.ts index 0871fb7f3a..b97d5d2af5 100644 --- a/src/dataservices/feed.service.ts +++ b/src/dataservices/feed.service.ts @@ -29,7 +29,7 @@ export class FeedService { * Attempts to add a feed to the Nextcloud News backend * NOTE: this can fail if feed URL is not resolvable * - * @param param0 + * @param param0 Data for the feed * @param param0.url {String} url of the feed to add * @param param0.folderId {number} id number of folder to add feed to * @param param0.user {String} http auth username required for accessing feed @@ -50,7 +50,7 @@ export class FeedService { /** * Marks all items in feed, started with highestReadId * - * @param param0 + * @param param0 Data for the feed * @param param0.feedId {Number} ID number of feed to mark items as read * @param param0.highestItemId {Number} ID number of the (most recent?) feed item to mark as read (all older items will be marked as read) * @return {AxiosResponse} Updated feed info (unreadCount = 0) stored in data.feeds[0] property @@ -64,7 +64,7 @@ export class FeedService { /** * Update a feeds properties * - * @param param0 + * @param param0 Data for the feed * @param param0.feedId {Number} ID number of feed to update * @param param0.pinned {Boolean} should be pinned (true) or not pinned (flse) * @param param0.ordering {FEED_ORDER} sets feed order (0 = NEWEST, 1 = OLDEST, 2 = DEFAULT) @@ -86,7 +86,7 @@ export class FeedService { /** * Deletes a feed * - * @param param0 + * @param param0 Data for the feed * @param param0.feedId {Number} ID number of feed to delete * @return {AxiosResponse} Null value is returned on success */ diff --git a/src/dataservices/folder.service.ts b/src/dataservices/folder.service.ts index 7f1e42aa7f..224263e100 100644 --- a/src/dataservices/folder.service.ts +++ b/src/dataservices/folder.service.ts @@ -17,7 +17,7 @@ export class FolderService { /** * Creates a new Folder in the Nextcloud News backend * - * @param param0 + * @param param0 Folder data * @param param0.name {String} New Folder Name * @return {AxiosResponse} Folder info from backend in data.folders[0] property */ @@ -28,7 +28,7 @@ export class FolderService { /** * Update a folder name * - * @param param0 + * @param param0 Folder data * @param param0.id {Number} ID number of folder to update * @param param0.name {String} name to set for folder * @return {AxiosResponse} Null value is returned on success @@ -42,7 +42,7 @@ export class FolderService { /** * Deletes a folder in the Nextcloud News backend (by id number) * - * @param param0 + * @param param0 Folder data * @param param0.id {number} id of folder to delete * @return {AxiosResponse} */ diff --git a/src/main.js b/src/main.js index 97e48b4423..02ccfc7a92 100644 --- a/src/main.js +++ b/src/main.js @@ -25,7 +25,7 @@ const store = new Store(mainStore) * Handles errors returned during application runtime * * @param {Error} error Error thrown - * @return Promise + * @return {Promise} Error promise */ const handleErrors = function(error) { store.commit(MUTATIONS.SET_ERROR, error) diff --git a/src/store/item.ts b/src/store/item.ts index 4d714305e1..ecb2694605 100644 --- a/src/store/item.ts +++ b/src/store/item.ts @@ -66,9 +66,9 @@ export const actions = { * Fetch Unread Items from Backend and call commit to update state * * @param param0 ActionParams - * @param param0.commit + * @param param0.commit Commit data * @param param1 ActionArgs - * @param param1.start + * @param param1.start Start arg */ async [FEED_ITEM_ACTION_TYPES.FETCH_UNREAD]( { commit }: ActionParams, @@ -93,9 +93,9 @@ export const actions = { * Fetch All Items from Backend and call commit to update state * * @param param0 ActionParams - * @param param0.commit + * @param param0.commit Commit param * @param param1 ActionArgs - * @param param1.start + * @param param1.start Start data */ async [FEED_ITEM_ACTION_TYPES.FETCH_ITEMS]( { commit }: ActionParams, @@ -122,9 +122,9 @@ export const actions = { * Fetch Starred Items from Backend and call commit to update state * * @param param0 ActionParams - * @param param0.commit + * @param param0.commit Commit param * @param param1 ActionArgs - * @param param1.start + * @param param1.start Start data */ async [FEED_ITEM_ACTION_TYPES.FETCH_STARRED]( { commit }: ActionParams, @@ -152,10 +152,10 @@ export const actions = { * Fetch All Feed Items from Backend and call commit to update state * * @param param0 ActionParams - * @param param0.commit + * @param param0.commit Commit param * @param param1 ActionArgs - * @param param1.start - * @param param1.feedId + * @param param1.start Start data + * @param param1.feedId ID of the feed */ async [FEED_ITEM_ACTION_TYPES.FETCH_FEED_ITEMS]( { commit }: ActionParams, @@ -179,10 +179,10 @@ export const actions = { * Fetch Folder Items from Backend and call commit to update state * * @param param0 ActionParams - * @param param0.commit + * @param param0.commit Commit param * @param param1 ActionArgs - * @param param1.start - * @param param1.folderId + * @param param1.start Start data + * @param param1.folderId ID of the folder */ async [FEED_ITEM_ACTION_TYPES.FETCH_FOLDER_FEED_ITEMS]( { commit }: ActionParams, @@ -206,10 +206,10 @@ export const actions = { * Sends message to Backend to mark as read, and then call commit to update state * * @param param0 ActionParams - * @param param0.commit - * @param param0.dispatch + * @param param0.commit Commit action + * @param param0.dispatch Dispatch action * @param param1 ActionArgs - * @param param1.item + * @param param1.item Item argument */ [FEED_ITEM_ACTION_TYPES.MARK_READ]( { commit, dispatch }: ActionParams, @@ -230,10 +230,10 @@ export const actions = { * Sends message to Backend to mark as unread, and then call commit to update state * * @param param0 ActionParams - * @param param0.commit - * @param param0.dispatch + * @param param0.commit Commit action + * @param param0.dispatch Dispatch * @param param1 ActionArgs - * @param param1.item + * @param param1.item Item */ [FEED_ITEM_ACTION_TYPES.MARK_UNREAD]( { commit, dispatch }: ActionParams, @@ -254,9 +254,9 @@ export const actions = { * Sends message to Backend to mark as starred, and then call commit to update state * * @param param0 ActionParams - * @param param0.commit + * @param param0.commit Commit action * @param param1 ActionArgs - * @param param1.item + * @param param1.item Item */ [FEED_ITEM_ACTION_TYPES.STAR_ITEM]( { commit }: ActionParams, @@ -273,9 +273,9 @@ export const actions = { * Sends message to Backend to remove mark as starred, and then call commit to update state * * @param param0 ActionParams - * @param param0.commit + * @param param0.commit Commit action * @param param1 ActionArgs - * @param param1.item + * @param param1.item Item */ [FEED_ITEM_ACTION_TYPES.UNSTAR_ITEM]( { commit }: ActionParams,