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

docs: add clarification about goals of this project #33

Merged
merged 3 commits into from
Sep 22, 2018
Merged

Conversation

bcoe
Copy link
Owner

@bcoe bcoe commented Sep 20, 2018

@demurgos and I have been having long conversations about implementation details surrounding c8, and I think part of the problem was that I've done a poor job of describing the goals I have in mind (they lived only in my head, which isn't useful).

tldr; I'd like this project to demonstrate a powerful code coverage solution relying primarily on native V8 functionality, and minimal user-land modules.

data-transformations are okay, but I don't want to parse JavaScript with Babel, muck with Node's runtime, etc.

@bcoe bcoe requested a review from JaKXz September 20, 2018 22:25
@coveralls
Copy link

coveralls commented Sep 20, 2018

Pull Request Test Coverage Report for Build 47

  • 0 of 0 changed or added relevant lines in 0 files are covered.
  • No unchanged relevant lines lost coverage.
  • Overall coverage remained the same at 90.934%

Totals Coverage Status
Change from base Build 36: 0.0%
Covered Lines: 214
Relevant Lines: 218

💛 - Coveralls

Copy link
Contributor

@profnandaa profnandaa left a comment

Choose a reason for hiding this comment

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

Sounds good, I'm in.

JaKXz
JaKXz previously requested changes Sep 21, 2018
Copy link

@JaKXz JaKXz left a comment

Choose a reason for hiding this comment

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

Minor issues to fix, but looks great! I've been somewhat following the discussions and this kind of clarity is excellent and a clear win in the collaborative department :)

README.md Outdated
## Goals of Project

A fully functional code coverage solution using only V8's native coverage
features and minimal user-land modules:
Copy link

Choose a reason for hiding this comment

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

Being strict here, this sentence does not really tell me what the following list is for. I would add:

...modules, so that we fit these constraints: or something to that effect.

Copy link
Contributor

Choose a reason for hiding this comment

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

Glad to make this change 👍

README.md Outdated

c8 uses
[bleeding edge Node.js features](https://github.com/nodejs/node/pull/22527),
make sure you're running Node.js `>= 10.10.0`.

## Goals of Project
Copy link

Choose a reason for hiding this comment

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

nit: Goals of this Project or Goals of the Project.

Copy link
Contributor

Choose a reason for hiding this comment

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

On it 👍

@bcoe
Copy link
Owner Author

bcoe commented Sep 22, 2018

@profnandaa I'll let you make these couple patches since you've put your hand up; have a couple other tasks on my plate today, but we can land as soon as we've satisfied @JaKXz.

@demurgos
Copy link
Contributor

Looks good to me, thanks for adding this!

mcknasty pushed a commit to mcknasty/c8 that referenced this pull request Feb 2, 2024
Clarify project goals: I'd like this project to demonstrate a powerful code coverage solution relying primarily on native V8 functionality, and minimal user-land modules -- @bcoe
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.

5 participants