Skip to content

SEO-08–10: guidance pages + scientific foundation + internal linking - #94

Merged
Alhareith merged 44 commits into
mainfrom
feature/seo-choose-major-guide
Oct 4, 2026
Merged

Alhareith merged 44 commits into
mainfrom
feature/seo-choose-major-guide

Conversation

@Alhareith

@Alhareith Alhareith commented Oct 4, 2026 •

Copy link
Copy Markdown
Member

SEO-08–10 — Major choice guide + scientific foundation + internal linking

Starts from main after merged PR #93 / SEO-07.

SEO-08 — How to choose a university major

Search intent

  • كيف أختار تخصصي الجامعي
  • كيف أختار تخصصي
  • محتار أي تخصص أدخل
  • ماذا أدرس بعد الثانوية

Included

  • public route /how-to-choose-university-major
  • route name major-choice.index
  • search-focused guide based on Masarak's decision flow:
    • افهم نفسك
    • افهم الخيارات
    • قارن بوعي
  • covers interests, abilities/readiness to learn, study nature, values/goals, real constraints, and exploration
  • avoids promising one perfect major or treating one test as a final answer
  • links to the career-interests page, specialization catalog, and scientific foundation

SEO-09 — Public scientific foundation

Included

  • public route /scientific-foundation
  • route name scientific-foundation.index
  • public explanation of what Masarak measures and what it does not claim
  • Holland RIASEC as the primary vocational-interest measurement model
  • approved six Arabic RIASEC labels
  • SCCT and SEVT described as supporting frameworks rather than automatic RIASEC score inputs
  • explicit scientific boundaries:
    • not an intelligence/ability test
    • not a mental-health or comprehensive personality diagnosis
    • no guarantee of academic success, employment, or income
    • no uniquely correct major claim
    • no presentation of scores as comparison to an unavailable Yemeni national norm
  • links to core scientific sources and to the user decision journey

SEO-10 — Internal linking + visible breadcrumbs

Included

  • direct contextual links from the home page to:
    • career interests
    • major choice guide
    • scientific foundation
  • visible breadcrumb added to the specialization catalog:
    • الرئيسية → دليل التخصصات الجامعية
  • visible breadcrumb added to specialization detail pages:
    • الرئيسية → دليل التخصصات الجامعية → التخصص الحالي
  • visible breadcrumbs now exist across every public guide/catalog page and match the existing JSON-LD hierarchy
  • contextual decision links added from the specialization catalog to:
    • major choice guide
    • career interests
    • scientific foundation
  • contextual decision links added from specialization detail pages to:
    • major choice guide
    • career interests
  • duplicate الأساس العلمي footer link removed
  • footer contract tests ensure each core public guidance destination appears exactly once
  • no new routes or sitemap entries were added by SEO-10 itself

Shared SEO integration

  • SEO-08 and SEO-09 are public/indexable
  • central canonical / OG / Twitter metadata retained
  • WebPage + ImageObject + BreadcrumbList retained
  • sitemap public URL count: 15
  • private/noindex policy unchanged

Final verification

Latest head: 587ef13550ed2db37cf058847668a29088f20700

  • migrations: PASS
  • Laravel tests: 473 passed, 4 skipped, 3367 assertions
  • SeoInternalLinkingTest: PASS (5 tests)
  • SeoMajorChoiceGuideTest: PASS
  • SeoScientificFoundationTest: PASS
  • SeoHeadTest: PASS
  • SeoIndexingFoundationTest: PASS
  • SeoNoIndexTest: PASS
  • SeoStructuredDataTest: PASS
  • npm ci: PASS
  • npm run build: PASS
  • push CI on exact head SHA: SUCCESS
  • PR CI on exact head SHA: SUCCESS

Final scientific-reference correction

  • corrected the foundational SCCT DOI in the public scientific page to 10.1006/jvbe.1994.1027
  • corrected the same DOI in docs/04-assessment/scientific_theoretical_framework.md
  • regression coverage now asserts the correct DOI and rejects the previous incorrect DOI

Scope

No scoring changes, no assessment access-policy changes, no result changes, no database changes, and no production deployment changes.

Ready for review; do not merge automatically.

@Alhareith Alhareith changed the title SEO-08: how to choose a university major guide SEO-08–09: major choice guide + scientific foundation Oct 4, 2026
@Alhareith Alhareith changed the title SEO-08–09: major choice guide + scientific foundation SEO-08–10: guidance pages + scientific foundation + internal linking Oct 4, 2026
@Alhareith
Alhareith merged commit 0a4ff9a into main Oct 4, 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.

3 participants