Add consensus documentation

[zhiltsov-max]

Motivation and context

Related #8434
Closes #8401

• Added documentation for the consensus feature

How has this been tested?

Checklist

• I submit my changes into the develop branch
• I have created a changelog fragment
• I have updated the documentation accordingly
• I have added tests to cover my changes
• I have linked related issues (see GitHub docs)

License

• I submit my code changes under the same MIT License that covers the project.
  Feel free to contact the maintainers if that's a concern.

[SpecLad]

Suggested change

	If you want to improve quality of your annotations, there are several widespread ways
	If you want to improve the quality of your annotations, there are several widespread ways

[SpecLad]

I think you missed this?

[zhiltsov-max]

I'm not convinced this is a correct case for "the", nor I could find a reliable source where using "the" in this case is justified. From my perspective, "quality" is an uncountable noun in this context. It can be countable, but not in this meaning.

https://en.wiktionary.org/wiki/quality - meaning breakdown with countability

[SpecLad]

It is uncountable, but that only matters for indefinite articles. In this case, I believe using "the" is justified, as you're referring to a specific kind of quality.

In addition, Google Ngram shows that the variant with "the" is significantly more common.

[zhiltsov-max]

Ok, let's trust the majority voting then.

[SpecLad]

I can see compression artifacts. Please retake these screenshots as PNG.

[zhiltsov-max]

Updated, it was just 30% quality setting

[SpecLad]

But they're still JPEGs. Why not save them as PNG?

[zhiltsov-max]

Because the original pngs are 2x of the current size

[SpecLad]

Have you tried processing them with zopflipng? That can yield significant size reduction without any quality loss.

[zhiltsov-max]

It could achieve the size of 70% jpgs, winning us about 10kb. Actually, I think it makes sense to run this tool for all pngs in the repository.

[SpecLad]

Actually, I think it makes sense to run this tool for all pngs in the repository.

Eh, I'd rather not add new binary blobs to the repository if the contents are equivalent. (I'd be up for replacing JPEG screenshots with PNG, though.)

[SpecLad]

By the way, maybe we should use WebP going forward. I just tried to recompress these images out of curiosity, and cwebp -z 9 brings the total size down by 60%, with zero quality loss. 🤯

[zhiltsov-max]

I experimented a little bit with webp encoding when I tried to replace pngs for HP. I discovered noticeable compression artifacts, for instance around curve objects. Maybe it was because of specific settings.

[SpecLad]

Yeah, WebP has both lossy and lossless variants, so you have to be careful. The -z option enables lossless encoding.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud