Skip to content
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

Cleaning up to get ready for publishing to npm #129

Merged
merged 10 commits into from
Jul 12, 2016
Merged

Cleaning up to get ready for publishing to npm #129

merged 10 commits into from
Jul 12, 2016

Conversation

lilleyse
Copy link
Contributor

@lilleyse lilleyse commented Jul 8, 2016

@mramato Would you like to take a quick look here?

@@ -0,0 +1,165 @@
// Type definitions for Async 1.4.2
Copy link
Contributor

Choose a reason for hiding this comment

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

What is this for? Part of the async package? Does it need to be in this location?

Copy link
Contributor

Choose a reason for hiding this comment

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

Was this directory supposed to be submitted?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I saw that it was included in some of our other repos, @mramato should it be included?

Copy link
Contributor

Choose a reason for hiding this comment

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

Yes, for now this directory should be submitted. These are TypeScript definition files that aid Webstorm in intellisense and error checking and get updated when you update dependencies in package.json. They are discussed in my upcoming node guide. I'm hoping to improve things in the long term so that these will be handled slightly differently (and possibly not submitted) but for now this is the same thing we do in all of our other modules.

@pjcozzi
Copy link
Contributor

pjcozzi commented Jul 10, 2016

@lilleyse tangentially related: did you create a roadmap issue for the other cleanup for gltf-pipeline?

@mramato
Copy link
Contributor

mramato commented Jul 11, 2016

@lilleyse I updated my guide to flesh out the publishing section some more: https://github.com/AnalyticalGraphicsInc/agi-cesium-people/tree/node-coding-guide/NodeCodingGuide#publishing-and-versioning-your-module It now has a section on the "first time" you publish.

@lilleyse
Copy link
Contributor Author

@lilleyse tangentially related: did you create a roadmap issue for the other cleanup for gltf-pipeline?

Not yet, I do have a running list of issues that I can create an issue for soon.

@lilleyse
Copy link
Contributor Author

@lilleyse I updated my guide to flesh out the publishing section some more:

Cool thanks, I'll check it out.

@lilleyse
Copy link
Contributor Author

Are there any other suggestions for this?

@@ -8,6 +8,9 @@ describe('addPipelineExtras', function() {

beforeAll(function(done) {
fs.readFile(gltfExtrasPath, function(err, data) {
if (err) {
Copy link
Contributor

Choose a reason for hiding this comment

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

Use defined here (though I know this will eventually go away when everything is promisified.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

There are too many areas that we do this right now, I think I'm just going to save this for the cleanup.

@mramato
Copy link
Contributor

mramato commented Jul 12, 2016

Are we planning on publishing this with callbacks and the breaking backwards compatibility when we refactor for promises? Refactoring should be pretty easy and will clean up a lot of the boilerplate code, so I would recommend we do it sooner rather than later.

@mramato
Copy link
Contributor

mramato commented Jul 12, 2016

That's all the comments I have.

@lilleyse
Copy link
Contributor Author

Are we planning on publishing this with callbacks and the breaking backwards compatibility when we refactor for promises? Refactoring should be pretty easy and will clean up a lot of the boilerplate code, so I would recommend we do it sooner rather than later.

That's a good question. We still have a lot of cleanup to do #130, but at the same time we want to update the online model converter soon... @pjcozzi thoughts?

@mramato
Copy link
Contributor

mramato commented Jul 12, 2016

@lilleyse I believe as long as you keep the version to x.0.0, you can break compatibility whenever you want. Another option would be to publish 0.1.0-alpha1 and then just increment alpha2/alpha3/etc... this is a valid node version and is standard for pre-release libraries (but still allows us to publish to npm and use it as a dependency.

@lilleyse
Copy link
Contributor Author

Okay, 0.1.0-alpha1 seems fitting then.

@pjcozzi
Copy link
Contributor

pjcozzi commented Jul 12, 2016

We still have a lot of cleanup to do #130, but at the same time we want to update the online model converter soon... @pjcozzi thoughts?

No worries, publishing 0.1.0-alpha1 now and having a breaking change later.

@pjcozzi
Copy link
Contributor

pjcozzi commented Jul 12, 2016

Update the README.md since the npm scripts changed, e.g., npm run jasmine -> npm run test

@lilleyse
Copy link
Contributor Author

Updated

@pjcozzi
Copy link
Contributor

pjcozzi commented Jul 12, 2016

Nice!

@pjcozzi pjcozzi merged commit 5e8d759 into master Jul 12, 2016
@pjcozzi pjcozzi deleted the publish branch July 12, 2016 18:54
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.

3 participants