Skip to content

fix(gen-docs): fix issue where docs are generated wrong#310

Merged
ariporad merged 1 commit intoshelljs:masterfrom
nfischer:fix-gen-docs
Jan 26, 2016
Merged

fix(gen-docs): fix issue where docs are generated wrong#310
ariporad merged 1 commit intoshelljs:masterfrom
nfischer:fix-gen-docs

Conversation

@nfischer
Copy link
Copy Markdown
Member

This fixes an issue (#309) where the gen-docs script's sed() command would improperly
update the docs.

As a bonus, Travis now checks that docs are generated properly (or, more specifically, that no files have been changed by running the tests and re-generating docs, which is exactly what we want). This prevents breaking changes in sed() from going unnoticed. This will also prevent people from modifying doc-comments in the source files without generating docs, or by modifying the README manually without changing comments.

@nfischer nfischer added fix Bug/defect, or a fix for such a problem high priority labels Jan 25, 2016
This fixes an issue where the gen-docs script's sed() command would improperly
update the docs. Travis now checks that docs are generated properly.
@nfischer
Copy link
Copy Markdown
Member Author

@ariporad could you take a look at this when you get the chance?

@nfischer
Copy link
Copy Markdown
Member Author

Also, we could consider switching to only one replace() (no sed()). The nice thing about keeping sed() there is that this tests it out to catch any unintended change, so I'm inclined to keep sed() in there (efficiency isn't a concern anyway).

@ariporad
Copy link
Copy Markdown
Contributor

LGTM

ariporad added a commit that referenced this pull request Jan 26, 2016
fix(gen-docs): fix issue where docs are generated wrong
@ariporad ariporad merged commit f224776 into shelljs:master Jan 26, 2016
@nfischer nfischer deleted the fix-gen-docs branch January 28, 2016 07:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

fix Bug/defect, or a fix for such a problem high priority

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants