feat: add various improvements

[0xpanoramix]

Description

This PR:

• Adds a bit of documentation
• Cleans the code
• Update the signal computation

Changes include

• Bugfix (non-breaking change that solves an issue).
• Hotfix (change that solves an urgent issue, and requires immediate attention).
• New feature (non-breaking change that adds functionality).
• Breaking change (change that is not backwards-compatible and/or changes current functionality).
• Documentation update (change added to any kind of documentation).

Checklist

• I have assigned this PR to myself.
• I have added at least 1 reviewer.
• I have added the relevant labels.
• I have updated the official documentation.
• I have added sufficient documentation in code.

Testing

• I have tested this code with the official test suite.
• I have tested this code manually.