The support of C-style
/** comments has been dropped.
You can use the following scripts to upgrade your codebase to
comments if you were using them:
The script can’t handle all the possible edge cases, so please make sure to run it in a version-controlled environment, and review carefully the changes.
You’ll also have to manually fix all your poster comments by hand
since there is no way for this script to convert them accurately; only
the closing can be converted, but you’ll need to add a
/ to all poster
If you want to know more on what’s happening in these cryptic
commands, here is the commented
The default value of some annotations is now inside square brackets
instead of parentheses. This affects
You can use the following script to update your codebase, though it will replace all the parentheses by square brackets in the lines containing the affected annotations, which may not be what you want (for example if there’s parentheses inside the default value or in the description).
Be sure to review the changes made by the script and eventually fix details by hand.
The CLI usage slightly changed, since the destination is now optional and configurable with an option instead of an argument, so you’ll have to update your scripts using SassDoc if you have any.
When you don’t give a destination, SassDoc will put the documentation in
sassdoc folder in the current directory.
SassDoc will wipe the whole destination folder upon each run, so be sure you don’t have anything important in it.
documentize function from 1.0 is now the default export from the
parse function still works the same way as in 1.0.
Starting from version 2.0 SassDoc core is fully Gulp compatible, and can be directly integrated in any Vinyl files pipeline. The Gulp plugin is now deprecated. Refer to the documentation for full examples.
Similarly to any Gulp plugin, passing a directory path to
gulp.src won’t work anymore.
You have to pass in glob patterns: