infection / site

Documentation for Infection - PHP Mutation Testing Framework

Infection PHP

This site is built with hexo. Site content is written in Markdown format located in src. Pull requests welcome!

URL: infection.github.io

Developing

Start a dev server at localhost:4000:

$ npm install -g hexo-cli
$ npm install
$ hexo server

Deploying

$ hexo deploy -g

This site was forked and inspired by Vue.js documentation site

site's Issues

Deployment seems to not work

Hi,

I just noticed that the site is older then the sources (at least of the master) would suggest. So something seems to be broken in the deployment pipeline...

https://github.com/infection/site/blob/master/src/guide/installation.md - shows infection 0.12
https://infection.github.io/guide/installation.html - shows 0.8

Force flushing ServiceWorker cache

See #126

UnwrapArrayMap and UnwrapArrayFilter are undocumented

See infection/infection#513

Metrics explanation possible need of improvement

Hi all,

First, thanks for the great project.

I've been reading the metrics explanation several times, and I have difficulty understanding the part related to coverage.

Can someone help me clarify some points?

After the discussion, if we feel that we can improve this part once done, I'll be glad to create a PR.

About the MSI, the documentation says:

Given the code coverage of 65%, there is a 18% difference so Code Coverage was a terrible quality measurement in this example.

I don't get where the 65% comes from. I guess it's just used as an example here. The "the" in the sentence feels like we've seen it before.

I don't understand the relation between the 18% difference and the conclusion of code coverage being a terrible quality measurement.
I can feel that there might be some relation between escaping mutants and code coverage, but I'm unable to formulate it properly in my head. Can someone help me with this?

Not really important for now, just to keep it in mind: 18% should probably be 18 points here, like later in the documentation.

I also have trouble with Mutation Code Coverage, mostly because I'm not sure what a not covered mutant is. My bet is that it's a mutant which mutation is on a line that tests do not cover. Is it correct?

Thanks in advance for your help.

Have a great day

Homebrew

Hello, I believe installation via homebrew died with homebrew-php

https://github.com/infection/site/blob/master/src/guide/installation.md#homebrew

Homebrew says Error: No available formula with the name "infection"

Integrate proselint

https://github.com/amperser/proselint/

Add italian translation

Hi @borNfreee, I would like to contribute with the italian translation.

Are you ok with this or do you prefer to keep all in English?

Update `How to run Infection only for changed files` topic

Hi, 4 years ago How to run Infection only for changed files was introduced in the How-to section, which is using the (still valid) CHANGED_FILES=$(git diff ...) method.

But now we have --git-diff-filter #183 and --git-diff-lines #228, so I think it is worth updating the main How-to guide to use the newer options, if I'm not missing anything.

Favicon

Hi! I noticed that your favicon is the Vue logo. While I love Vue, the Infection PHP logo may be a nicer favicon 👍

Update documentation for --coverage option

Make it more clear for users that Infection requires BOTH xml and junit reports.

Visually underline it.

From reporter:

I didn't really read it as "BOTH ... AND ...", rather like "supports ... AND ..."
because it's totally unnatural to require two reports that represent the same