diff --git a/src/material/core/theming/_theming.scss b/src/material/core/theming/_theming.scss
index e155a0ad5b99..52b30f4635d6 100644
--- a/src/material/core/theming/_theming.scss
+++ b/src/material/core/theming/_theming.scss
@@ -17,7 +17,7 @@ $_mat-theme-emitted-typography: () !default;
 $_mat-theme-emitted-density: () !default;
 
 // For a given hue in a palette, return the contrast color from the map of contrast palettes.
-// @param $color-map
+// @param $palette
 // @param $hue
 @function mat-contrast($palette, $hue) {
   @return map-get(map-get($palette, contrast), $hue);
@@ -26,9 +26,11 @@ $_mat-theme-emitted-density: () !default;
 
 // Creates a map of hues to colors for a theme. This is used to define a theme palette in terms
 // of the Material Design hues.
-// @param $color-map
-// @param $primary
+// @param $base-palette
+// @param $default
 // @param $lighter
+// @param $darker
+// @param $text
 @function mat-palette($base-palette, $default: 500, $lighter: 100, $darker: 700, $text: $default) {
   $result: map-merge($base-palette, (
     default: map-get($base-palette, $default),
@@ -56,7 +58,7 @@ $_mat-theme-emitted-density: () !default;
 // The hue can be one of the standard values (500, A400, etc.), one of the three preconfigured
 // hues (default, lighter, darker), or any of the aforementioned prefixed with "-contrast".
 //
-// @param $color-map The theme palette (output of mat-palette).
+// @param $palette The theme palette (output of mat-palette).
 // @param $hue The hue from the palette to use. If this is a value between 0 and 1, it will
 //     be treated as opacity.
 // @param $opacity The alpha channel value for the color.