docs: document Date input and add Notes section in time/iso-weeks-in-year

PR-URL: #12313
Reviewed-by: Athan Reines <kgryte@gmail.com>

Author: Planeshifter

lib/node_modules/@stdlib/time/iso-weeks-in-year/README.md

@@ -56,6 +56,16 @@ num = isoWeeksInYear( 2017 );
 
 <!-- /.usage -->
 
+<section class="notes">
+
+## Notes
+
+-   The function's return value is a generalization and does **not** take into account inaccuracies due to daylight savings conventions, crossing timezones, or other complications with time and dates.
+
+</section>
+
+<!-- /.notes -->
+
 <section class="examples">
 
 ## Examples

lib/node_modules/@stdlib/time/iso-weeks-in-year/docs/repl.txt

@@ -1,16 +1,20 @@
 
-{{alias}}( [year] )
+{{alias}}( [value] )
     Returns the number of ISO weeks in a year according to the Gregorian
     calendar.
 
     By default, the function returns the number of ISO weeks in the current year
     (according to local time). To determine the number of ISO weeks for a
     particular year, provide either a year or a `Date` object.
 
+    The function's return value is a generalization and does **not** take into
+    account inaccuracies due to daylight savings conventions, crossing
+    timezones, or other complications with time and dates.
+
     Parameters
     ----------
-    year: integer (optional)
-        Year.
+    value: integer|Date (optional)
+        Year or `Date` object.
 
     Returns
     -------

lib/node_modules/@stdlib/time/iso-weeks-in-year/docs/types/index.d.ts

@@ -24,6 +24,7 @@
 * ## Notes
 *
 * -   By default, the function returns the number of ISO weeks in the current year (according to local time). To determine the number of ISO weeks for a particular year, provide either a year or a `Date` object.
+* -   The function's return value is a generalization and does **not** take into account inaccuracies due to daylight savings conventions, crossing timezones, or other complications with time and dates.
 *
 * @param value - year or `Date` object
 * @returns number of ISO weeks in a year