kss-node / kss-node/kss-node

Add option to delete existing destination directory before generating style guide

Open
#181 1 comment 0 reactions 0 assignees View on GitHub
documentation feature request
Dominant language
JavaScript
Stars
1.5k
Forks
265
PR merge metrics
No merged PRs in 30d

Description

The styleguide `destination` directory is only created once by `kss-node`.

If I:
1. create a KSS comment in my stylesheet
2. generate the styleguide
3. later remove the comment from my stylesheet
4. regenerate the styleguide

.. the styleguide navigation reflects the change but the previously generated styleguide page is left behind. Over time this introduces cruft/confusion.

Currently I'm working around this with `grunt-contrib-clean`.

Thanks.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by tracing how kss-node creates the configured destination directory and where generation options are handled. Done means an opt-in option can remove the existing destination before generation, so pages for removed KSS comments are no longer left behind; verify the behavior with the relevant generation tests.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
documentation
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.