diff --git a/backend/visual_qc_apps/wsj_capitalization_punctuation/app.py b/backend/visual_qc_apps/wsj_capitalization_punctuation/app.py index 34f900d..f0ec942 100644 --- a/backend/visual_qc_apps/wsj_capitalization_punctuation/app.py +++ b/backend/visual_qc_apps/wsj_capitalization_punctuation/app.py @@ -61,16 +61,28 @@ RULE 6 — EYEBROWS AND CTAs: IF MINIMAL TEXT IS PRESENT: If the asset contains very little text (e.g., just a logo), score this check neutrally (7/10) and note limited text for evaluation. +DECISION TREE — HOW TO EVALUATE EACH HEADLINE: +Before scoring, you MUST classify each headline correctly: +A) Read the headline text. +B) Does it contain BOTH a subject AND a verb (i.e., is it a complete sentence)? + - YES → it is a COMPLETE SENTENCE → expect SENTENCE CASE (only first word and proper nouns capitalised). + Examples: "Insight that informs every decision." / "Find clarity in world-class coverage." / "Stay ahead of the top stories." + - NO → it is an INCOMPLETE SENTENCE (phrase or fragment) → expect TITLE CASE. + Examples: "Journalism Held to a Higher Standard." / "Business Journalism, Uncompromised." / "Reporting Without Bias." +C) Does it follow the "Make ___ Your Business." pattern? → always TITLE CASE regardless. +Do NOT penalise a complete sentence for using sentence case — that IS the correct rule. + STEPS TO EVALUATE: 1. Identify all visible text elements in the asset (headlines, subheaders, body copy, eyebrows, CTAs). 2. For each headline: check if it ends with a period. -3. For incomplete sentence headlines: verify Title Case rules are followed correctly. -4. For complete sentence headlines: verify sentence case is used. -5. Check eyebrow text is ALL CAPS. -6. Check CTA/button text is ALL CAPS. -7. Verify subheaders use sentence case with a period. -8. Look for any obvious capitalization errors (random capitals, missing capitals on proper nouns, etc.). -9. Check consistency across all text elements. +3. Classify each headline as complete sentence or incomplete sentence using the decision tree above. +4. For incomplete sentence headlines: verify Title Case rules are followed correctly. +5. For complete sentence headlines: verify sentence case is used. Do NOT flag sentence case as an error on complete sentences. +6. Check eyebrow text is ALL CAPS. +7. Check CTA/button text is ALL CAPS. +8. Verify subheaders use sentence case with a period. +9. Look for any obvious capitalization errors (random capitals, missing capitals on proper nouns, etc.). +10. Check consistency across all text elements. SCORING GUIDANCE: - Score 9-10: All headlines end with periods, capitalization rules followed correctly across all text elements, eyebrows/CTAs in ALL CAPS. diff --git a/backend/visual_qc_apps/wsj_color_usage/app.py b/backend/visual_qc_apps/wsj_color_usage/app.py index e7edc03..51e1028 100644 --- a/backend/visual_qc_apps/wsj_color_usage/app.py +++ b/backend/visual_qc_apps/wsj_color_usage/app.py @@ -47,9 +47,9 @@ Bold, full-intensity colors designed to command attention and challenge conventi Use cases: Bold/provocative messaging, urgency, unexpected delight, high-energy campaigns. COLOR COMBINATION RULES: -- Approved combinations: Pop color TEXT over Jewel color BACKGROUNDS (tested for accessibility). -- Heritage (black/white) can be used with any tier but is typically standalone. -- Jewel and Pop colors within the SAME tier should be used consistently — do not haphazardly mix Jewel and Pop colors in the same composition. +- PRIMARY APPROVED COMBINATION: Pop color text/accents over Jewel color backgrounds. This is the standard WSJ campaign approach and should score highly. For example, Pop Orchid (#E145F8) text or graphic accents on a Jewel Orchid (#400045) background is CORRECT and ON-BRAND — do NOT penalise this as "tier mixing." +- Heritage (black/white) can be used with any tier — white text on Jewel or Pop backgrounds, black text on light backgrounds. +- What IS a violation: using multiple unrelated Jewel colors as competing backgrounds in the same asset, or using Pop colors for large background areas when they should be Jewel. - Each color tier carries a specific tone: Heritage = authority/tradition, Jewels = depth/sophistication, Pops = energy/boldness. STEPS TO EVALUATE: diff --git a/backend/visual_qc_apps/wsj_imagery_expression/app.py b/backend/visual_qc_apps/wsj_imagery_expression/app.py index 8dd2bfb..af27651 100644 --- a/backend/visual_qc_apps/wsj_imagery_expression/app.py +++ b/backend/visual_qc_apps/wsj_imagery_expression/app.py @@ -59,7 +59,7 @@ IMPORTANT CONSIDERATIONS: - CROPPING: Cropping is encouraged as a powerful compositional tool to create impact. IF NO PHOTOGRAPHY IS PRESENT: -If the asset is purely typographic or uses only graphic elements with no photography, score this check neutrally (7/10) and note that the check is not applicable for this asset type. +If the asset is purely typographic, uses graphic/illustrative design elements (e.g., stylised price graphics, infographics, illustrative compositions), or has no photography, score this check neutrally (7/10) and note that the check is not applicable for this asset type. Graphic campaign creative is a legitimate WSJ approach — it does not require photography to be valid. STEPS TO EVALUATE: 1. Identify whether photography or imagery is present in the asset. diff --git a/backend/visual_qc_apps/wsj_layout_composition/app.py b/backend/visual_qc_apps/wsj_layout_composition/app.py index 5745b5b..f47d47e 100644 --- a/backend/visual_qc_apps/wsj_layout_composition/app.py +++ b/backend/visual_qc_apps/wsj_layout_composition/app.py @@ -47,13 +47,17 @@ WSJ LAYOUT AND COMPOSITION PRINCIPLES: - Text should remain legible when placed over images (adequate contrast). WSJ DESIGN VARIATIONS (for reference): -WSJ marketing assets come in several layout types: +WSJ marketing assets come in several legitimate layout types — ALL of these are valid and should be evaluated on their own terms: - Big Headline: Large dominant headline with supporting elements. -- 50/50: Split layout with image on one side, text on the other. +- 50/50: Split layout with graphic/image on one side, text on the other. - List: Multiple items/bullet points with supporting imagery. - Framed Image: Image contained within a frame/border. - Grid: Multiple images/elements in a structured grid. - Article: Editorial-style layout with headline, image, and body text. +- Graphic/Illustrative: Stylised graphic elements (price tags, infographics, illustrative compositions) alongside typography. These are intentional campaign creative — do NOT penalise bold graphic design as "chaotic" or "cluttered" if it is clearly a deliberate, structured composition. + +FORMAT AWARENESS: +Very small formats (320x50 banners, 300x250 boxes) have extremely limited space. Evaluate these proportionally — a banner with just a headline + CTA + logo can score 9-10 if those elements are well-structured and properly spaced for the format. Do not penalise small formats for lacking elements that physically cannot fit. STEPS TO EVALUATE: 1. Assess the overall visual hierarchy — is there a clear primary element (headline), secondary elements, and supporting elements? diff --git a/backend/visual_qc_apps/wsj_logo_compliance/app.py b/backend/visual_qc_apps/wsj_logo_compliance/app.py index beef730..d0eeb1b 100644 --- a/backend/visual_qc_apps/wsj_logo_compliance/app.py +++ b/backend/visual_qc_apps/wsj_logo_compliance/app.py @@ -22,8 +22,8 @@ The Wall Street Journal uses four logotype formats, all rendered ONLY in black o - Used on most creatives, especially those with messaging about journalism or the IYB (It's Your Business) campaign. - Placement: Always center-aligned on the creative. - Minimum clear space: Half of the cap-height of the logo text on all sides. - - Minimum size: 60% of the asset's shortest side (shortest side x 0.60). - - Alternative sizing: If the logo competes with content, use 30% of the longest side (longest side x 0.30). + - Standalone/logo-only usage: 60% of the asset's shortest side. + - Marketing assets with other content (headlines, body copy, imagery): Use 30% of the longest side. This is the STANDARD sizing for campaign creatives — most marketing assets will use this rule, not the 60% standalone rule. 2. PRIMARY IYB (IT'S YOUR BUSINESS) LOGOTYPE LOCKUP - The WSJ wordmark with the "It's Your Business." tagline. - Used on creatives with messaging about the value of the news product or the IYB campaign. @@ -40,7 +40,7 @@ The Wall Street Journal uses four logotype formats, all rendered ONLY in black o - Used on solid color backgrounds or overlaid on photos. - Common for: tall verticals, squares, end frames for animations/video. - NOT used on very short/wide horizontal assets or assets with other content. - - Minimum size: 60% of the asset's shortest side. + - Standalone/logo-only usage: 60% of the asset's shortest side. CRITICAL RULES: - Logo must ONLY appear in BLACK or WHITE. No other color variations are permitted. diff --git a/backend/visual_qc_apps/wsj_typography_hierarchy/app.py b/backend/visual_qc_apps/wsj_typography_hierarchy/app.py index 3aa5715..2c3b662 100644 --- a/backend/visual_qc_apps/wsj_typography_hierarchy/app.py +++ b/backend/visual_qc_apps/wsj_typography_hierarchy/app.py @@ -68,8 +68,11 @@ STEPS TO EVALUATE: 8. Assess whether text alignment is left-aligned or centered. 9. Evaluate overall typographic quality and consistency. +FORMAT AWARENESS: +Very small formats (320x50 banners, 300x250 boxes, 480x320) have extremely limited space and will naturally have FEWER hierarchy levels. A banner may only have room for a headline + CTA + logo — this is acceptable. Score based on whether the elements that ARE present follow WSJ typographic rules (serif headline, sans-serif body/CTA, period on headline), not on the number of hierarchy levels shown. A small-format asset with correct serif headline + sans-serif CTA + period can score 9-10. + SCORING GUIDANCE: -- Score 9-10: Clear serif/sans-serif hierarchy, strong size contrast (40%+), headlines end with period, no ligatures, proper alignment, eyebrows in ALL CAPS with wide tracking. +- Score 9-10: Clear serif/sans-serif hierarchy, strong size contrast (40%+), headlines end with period, no ligatures, proper alignment, eyebrows in ALL CAPS with wide tracking. Small formats: correct typefaces and rules for the elements present. - Score 7-8: Good hierarchy and mostly correct, minor issues (e.g., size contrast slightly under 40%, or one headline missing a period). - Score 5-6: Hierarchy present but with noticeable issues (wrong typeface style, weak size contrast, missing periods on headlines). - Score 3-4: Poor typographic hierarchy, significant rule violations (all sans-serif, no size contrast, no periods).