Skip to content

Add contributor's guide #69

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Sep 30, 2015
Merged

Add contributor's guide #69

merged 1 commit into from
Sep 30, 2015

Conversation

jbrantly
Copy link
Member

First pass at a contributor's guide. Does this make sense? Anything confusing or left out?

As a convenience it is possible to regenerate the expected output from the
actual output. This is useful when creating new tests and also when making a
change that affects multiple existing tests. To run use
`npm test -- --save-output`. Note that all tests will automatically pass when
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

-- --save-output. Typo?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not a typo. Allows arguments to be passed to the executing script. See https://docs.npmjs.com/cli/run-script

@basarat
Copy link
Member

basarat commented Sep 29, 2015

nice 😎

@johnnyreilly
Copy link
Member

Looks good!


To build from source you first need to `npm install`. You will also need a
version of TypeScript available, either globally or install locally with
`npm install typescript`. Then run `node build`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd simply this and make typescript a dev dependency. Then add an npm script for building the project. Here's my normal set up: https://github.com/blakeembrey/typescript-simple-loader/blob/master/package.json#L15-L21

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yea I'm good with changing to npm run build. I considered doing that originally. Not sure why I didn't. Regarding the dev dependency, that would probably work as long as it doesn't mess up the travis build.

@blakeembrey
Copy link
Member

Awesome 👍

jbrantly added a commit that referenced this pull request Sep 30, 2015
@jbrantly jbrantly merged commit 0a06d48 into master Sep 30, 2015
@jbrantly
Copy link
Member Author

Fixed the extensions issue. The other note regarding the build script I'll do as a separate PR. Thanks everyone.

@jbrantly jbrantly deleted the contributing-guide branch September 30, 2015 21:25
@jbrantly jbrantly mentioned this pull request Oct 6, 2015
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants