Skip to content

docs(mypolitics): quiz spec changes from the QA round decisions - #86

Merged
AdrianOrlow merged 9 commits into
mainfrom
mypolitics/qa-bugfix-decisions
Oct 9, 2026
Merged

AdrianOrlow merged 9 commits into
mainfrom
mypolitics/qa-bugfix-decisions

Conversation

@AdrianOrlow

@AdrianOrlow AdrianOrlow commented Oct 9, 2026 •

Copy link
Copy Markdown
Member

What

Spec changes that follow the decisions taken after the QA round on the result modules of mypolitics-app (epic gi-org-pl/mypolitics-app#144). Specs only - no docs or task files change.

Spec Change Decision
universal-axis.md New "With a comparison" part of the value label cases: a comparison no longer hides the numbers. A side keeps its value unless the other party's position is within a fixed clearance of the cap the number sits at; a value that would be written after the fill is hidden. The comparison cases link to it gi-org-pl/mypolitics-app#134, option B
double-axis-chart.md Below a fixed breakpoint of the title slot a tie title shows the word for a tie; at or above it both poles are named and names too long are truncated one by one. It never shows one pole alone gi-org-pl/mypolitics-app#137, option 2
horizontal-bar-chart.md A category with one entry has no control; a category with no result keeps its control only when it has more than one entry. One paragraph on why gi-org-pl/mypolitics-app#139, option A
nolan-chart.md The dot at an edge or a corner is drawn in full over the edge of the map, instead of "cut off" Not one of the three decisions - see below

Notes for the reviewer

  • The clearance in the universal axis is new vocabulary: a fixed percentage per mode, a little above the fit threshold, so the rule stays free of measuring, like the thresholds. The numbers themselves are left to the implementation, as the thresholds were.
  • Two Figma frames now disagree with the rule on values next to a comparison: the comparison states of the Universal Axis frame and the comparison example of the Double axis frame show no numbers (under the rule the latter shows "69%" on its start side). The pictures embedded in both specs are exports of those frames. They are not changed here - the frames have to be redrawn first - and both specs say so until then.
  • The tie title is a fixed breakpoint, not "when the names do not fit" (from review): whether a pair fits cannot be known without measuring. Above the breakpoint long names are truncated one by one. That part goes a step beyond the decision on DoubleAxisChart: the tie title shows one pole only mypolitics-app#137 and needs the Technical Leader's nod.
  • When the whole track is hatched no value is shown (from review) - the case of a double-sided bar whose start entry has no value.
  • Further points from review, all in the specs now: the comparison band ends at the taker's fill as drawn, also when the fills are scaled; a tie with a pole name missing shows the word for a tie, in the chip and in the accessible name; the Nolan chart frame is a third one to redraw (the dot at a corner), and its spec carries the same notice.
  • The Nolan chart sentence is a separate commit. It was not among today's decisions: it records what the module already does since feat: add NolanChart result module (#72) mypolitics-app#82 (a data mark is never cut). Drop the commit if it should not ride along.
  • Not included: the sentence about a wide screen and cards with an image in the QuizCard task - that deviation is still waiting for the owner's confirmation (feat: quiz card - one component per file, CSS-only width behaviour, keyboard access (#11) mypolitics-app#97). The decision on SurveyDemographics: the open list does not mark the chosen option mypolitics-app#143 (leave the demographics field as it is) needs no spec change.

Verification

  • The site was not built locally; the docs check on this pull request builds it; see the checks for the latest commit.
  • Codex reviewed six times and raised eight points in all. Seven are fixed in the specs and answered in their threads. The eighth - on a bar whose fills were scaled, the other party's position is not scaled, so the band can land on the wrong side of the fill - is existing behaviour for wrong input: the spec now names it as degraded output, and the question whether to scale the position is open in UniversalAxis: the taker's value is hidden in comparison mode mypolitics-app#134. The last commit, d2e3516 (one sentence in universal-axis.md), is not reviewed: the review bot answered that its usage limit is reached. To be requested again when the limit is back.
  • The one new in-page link (#with-a-comparison) points at a heading added in the same file.

🤖 Generated by Gieniek with Claude Code

AdrianOrlow and others added 2 commits October 9, 2026 17:48
…z specs

Decided by the Technical Leader on 2026-10-09, after the QA round on the
result modules in mypolitics-app:

- universal axis: a comparison no longer hides the taker's value; a side
  keeps its number wherever the band and the other party's image leave it
  uncovered (gi-org-pl/mypolitics-app#134)
- double axis chart: on a card too narrow for both names a tie title
  shows the word for a tie, never one pole alone
  (gi-org-pl/mypolitics-app#137)
- horizontal bar chart: a category with one entry has no control
  (gi-org-pl/mypolitics-app#139)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The spec said that whatever falls outside the map is cut off. The module
was delivered with the dot drawn in full over the edge, because a data
mark is never cut (AGENTS.md of mypolitics-app, section 3.4; decision
recorded in gi-org-pl/mypolitics-app#82). The sentence is brought in line
with that.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 9, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-09T16:10:24.657314Z 5660c03 Manual request
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: aa1276c6fb

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread mypolitics/spec/quiz/double-axis-chart.md Outdated
Comment thread mypolitics/spec/quiz/universal-axis.md
Comment thread mypolitics/spec/quiz/universal-axis.md
From review:

- double axis chart: the tie title switches on a fixed breakpoint of the
  title slot, not on whether the names fit, which could not be known
  without measuring; names too long for a wide slot are truncated one by
  one, so both poles stay visible
- universal axis: when the whole track is hatched, no value is shown on
  either side
- both specs say that the frame at the top of the page predates the rule
  on values next to a comparison and is to be redrawn

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@AdrianOrlow

Copy link
Copy Markdown
Member Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e7b3565719

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread mypolitics/spec/quiz/universal-axis.md
…ll as drawn

From review: with values that exceed the track the fills are scaled, and
the spec did not say whether the band follows the value as given or the
scaled fill. It follows the fill, as the implementation does, which is
what makes the position of the other party enough to decide whether a
number stays visible.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@AdrianOrlow

Copy link
Copy Markdown
Member Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 2d74756ed7

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread mypolitics/spec/quiz/double-axis-chart.md
…shows the tie word

From review: with one name missing, naming "both" poles would show the
surviving one alone, which is exactly what the tie title must never do;
with both missing the chip would be empty. In both cases the chip shows
the word for a tie, at any width.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@AdrianOrlow

Copy link
Copy Markdown
Member Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5b4433ee39

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread mypolitics/spec/quiz/double-axis-chart.md
… missing pole name

From review: the fallback to the word for a tie covered the visible chip
only. The card's accessible name follows it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@AdrianOrlow

Copy link
Copy Markdown
Member Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 84f35a988a

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread mypolitics/spec/quiz/nolan-chart.md
…on the dot at an edge

From review: the picture on the page shows the corner dot differently
from the rule. It is an export of the Figma frame, which is to be
redrawn; the spec says so until then, as the other two changed specs do.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@AdrianOrlow

Copy link
Copy Markdown
Member Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5660c03cd3

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread mypolitics/spec/quiz/universal-axis.md Outdated
| Other is at 0 or 100 | The image is clamped so it stays fully inside the track |
| Double-sided bar | The band is measured against the start entry on the same shared track |

The band always ends at the taker's fill as it is drawn. When two values exceed the track and the fills are scaled, the band follows the scaled fill, not the value as given, so it never runs past the fill it belongs to.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Preserve comparison direction after scaling fills

When a double-sided bar exceeds 100, ending the band at the scaled fill can reverse the documented comparison direction. For example, start/end values of 90/90 put the rendered start fill at 50, while another party's value of 70 is behind the taker's raw 90; the resulting band from 50 to 70 lies past the fill rather than over it, contradicting the “other is behind” rule and visually presenting the other party as ahead. Define comparison ordering and positioning in the same scaled coordinate system, or otherwise handle cases where scaling moves the taker's fill across the comparison value.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Right about the fact: with 90 / 90 the start fill is drawn at 50 while the other party's 70 is not scaled, so the band lands past the fill although 70 is behind the value as given. This is how the bar already degrades for input that is wrong to begin with (two sides of one axis exceeding 100), and this pull request does not change it. Not fixed here, because scaling the other party's position as well is a change of behaviour that nobody has decided. d2e3516 makes the spec say that the result is degraded and the band can then be on the other side of the fill, and the question is recorded as an open point in gi-org-pl/mypolitics-app#134.

…aled bar

From review: on a bar whose fills were scaled the other party's position
is not scaled, so the band can sit on the other side of the fill than
the values as given would put it. That is how the bar degrades today for
input that is already wrong; the spec now says so instead of implying a
correct result. Whether the position should be scaled too is left open
in gi-org-pl/mypolitics-app#134.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@AdrianOrlow

Copy link
Copy Markdown
Member Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

Brings in the questionnaire specs and tasks (#85). universal-axis.md was
changed on both sides and merged without conflicts.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@AdrianOrlow
AdrianOrlow merged commit 047200d into main Oct 9, 2026
2 checks passed
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.

1 participant