Deleted documentation is not removed from the site

[tomgreever]

If I want to remove a page from the documentation, I cannot just remove the comments from the code. The page will not be deleted when the site is generated. I have to delete the existing site first and then generate the site again.

I would expect documentjs to remove all the existing pages before generating the site.

[tforssander]

Until this is fixed I solved it temporarily by using the watch module together with the follow package.json scripts:

  "scripts": {
    "clean": "rm -r styleguide/*",
    "build": "npm run clean && ./node_modules/.bin/documentjs",
    "build:watch": "watch 'npm run build' ./src --ignoreDotFiles --ignoreUnreadable"
  }

[ramblinjan]

@tomgreever Would you expect it to selectively delete only the pages that documentjs generated (hard to implement) or would you expect it to wipe out everything in the dest folder (easy to implement)?

[tomgreever]

I think wiping out the entire folder is fine because it will regenerate it. From a user perspective, there is no difference between the two so do the easy one!

[justinbmeyer]

That might not be a great idea ... To wipe the old one. This can sometimes be the public folder with a lot of other resources.

Instead, we could generate a docMap.json, and do a diff everytime.

Sent from my iPhone

On Aug 19, 2015, at 5:55 PM, Tom Greever notifications@github.com wrote:

I think wiping out the entire folder is fine because it will regenerate it. From a user perspective, there is no difference between the two so do the easy one!

—
Reply to this email directly or view it on GitHub.

[justinbmeyer]

Wiping out the whole folder.

Sent from my iPhone

On Aug 19, 2015, at 5:55 PM, Tom Greever notifications@github.com wrote:

I think wiping out the entire folder is fine because it will regenerate it. From a user perspective, there is no difference between the two so do the easy one!

—
Reply to this email directly or view it on GitHub.