diff --git a/packages/edit-site/src/components/style-book/categories.js b/packages/edit-site/src/components/style-book/categories.js index 2c4bffd098313..dc564960a3c0c 100644 --- a/packages/edit-site/src/components/style-book/categories.js +++ b/packages/edit-site/src/components/style-book/categories.js @@ -3,10 +3,10 @@ * * @typedef {Object} StyleBookCategory * - * @property {string} slug Object with named attributes. - * @property {string} title Object with named attributes. - * @property {Array?} blocks Object with named attributes. - * @property {Array?} excludes Array with numeric attributes. + * @property {string} slug Category identifier. + * @property {string} title Category title/label. + * @property {Array?} blocks Array of block names to include in the category. Used when blocks are not included in the category by default. + * @property {Array?} excludes Array of blocks to exclude from the category. Used when blocks are included in the category by default. */ /** @@ -25,10 +25,10 @@ * * @typedef {Object} CategoryExamples * - * @property {string} slug Slug of the category. - * @property {string} title Title of the category for the UI. - * @property {Array?} examples Object with named attributes. - * @property {Array?} subcategories Array with numeric attributes. + * @property {string} slug Category identifier. + * @property {string} title Category title/label. + * @property {Array?} examples Array of block examples. + * @property {Array?} subcategories Array of subcategory examples. */ /**