Update jsdocs

tests/e2e/modules/weather_spec.js

@@ -13,7 +13,9 @@ describe("Weather module", function () {
 	helpers.setupTimeout(this);
 
 	/**
-	 * @param responses
+	 *
+	 * @param {object} responses mocked data to be returned
+	 * @returns {Promise} Resolved once the electron app is started
 	 */
 	async function setup(responses) {
 		app = await helpers.startApplication({
@@ -27,15 +29,18 @@ describe("Weather module", function () {
 	}
 
 	/**
-	 * @param element
+	 *
+	 * @param {string} element css selector
+	 * @returns {Promise<Element>} Promise with the element once it is rendered
 	 */
 	async function getElement(element) {
 		return await app.client.$(element);
 	}
 
 	/**
-	 * @param element
-	 * @param result
+	 * @param {string} element css selector
+	 * @param {string} result Expected text in given selector
+	 * @returns {Promise<boolean>} Promise with True if the text matches
 	 */
 	async function getText(element, result) {
 		const elem = await getElement(element);