DOC: Add comments to page module

[MartinThoma]

Just some comments + a tiny refactoring. Both hopefully make the code a little bit easier to read :-)

Oh, and process_operation should very likely rather be called process_operator (I can undo that if you think the previous name fits better :-) )

[stefan6419846]

An operation takes an operator and parameters (operands) and evaluates them, thus I think that process_operation fits better. But this probably is a matter of taste.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 96.71%. Comparing base (bd9fff0) to head (3c833f5).
Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #3319   +/-   ##
=======================================
  Coverage   96.71%   96.71%           
=======================================
  Files          53       53           
  Lines        9046     9046           
  Branches     1675     1675           
=======================================
  Hits         8749     8749           
  Misses        177      177           
  Partials      120      120           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[MartinThoma]

@stefan6419846 I undid the name change + the tiny refactoring as it increased the cyclomatic complexity and thus made the test fail -.-

Now it's a comment-only PR 😄

[stefan6419846]

Slightly related to #3010, where the goal is to refactor this rather complex method as well to increase readability and modularization.

[stefan6419846]

Could you please unify the casing of the comments to always start with an uppercase letter?

[MartinThoma]

Could you please unify the casing of the comments to always start with an uppercase letter?

Done 👍