2.4 KiB

Raw Blame History

Epic 8: Functional Debt

Epic Goal

To address functional limitations and gaps in the system that prevent users from achieving specific business requirements, particularly around customization and control of content generation and linking behavior.

Rationale

While the system provides automated content generation with sensible defaults, there are cases where users need explicit control over specific aspects (like anchor text terms) that don't fit the standard algorithmic approach. This epic addresses these functional gaps to provide the flexibility needed for real-world use cases.

Status

Story 8.1: 🔄 PLANNING (Job-Level Anchor Text Control)

Stories

Story 8.1: Job-Level Anchor Text Control for T1 and T2+

Estimated Effort: 2 story points

As a user, I want to explicitly specify anchor text terms in my job configuration for both Tier 1 and Tier 2+ links, so that I can include specific terms (like "high volume") that aren't covered by the standard algorithm.

Acceptance Criteria:

Job JSON supports explicit anchor text configuration for both Tier 1 and Tier 2+
Anchor text can be specified at job-level (applies to all tiers) or tier-level (tier-specific)
When explicit anchor text is provided, it should be used in addition to or instead of algorithm-generated anchor text
Support for multiple anchor text terms per tier
Anchor text terms are used when injecting links (tiered links, homepage links, etc.)
If explicit anchor text is provided, it takes precedence over algorithm-generated terms
Backward compatible: existing jobs without explicit anchor text continue to work with current algorithm

Technical Notes:

Extend anchor_text_config in job JSON to support explicit term lists
Update _get_anchor_texts_for_tier() in content_injection.py to prioritize explicit terms
Consider adding a new mode like "explicit" that uses only the provided terms, or extend "override" mode
Document in JOB_FIELD_REFERENCE.md how to use explicit anchor text

Example Job Configuration:

{
  "jobs": [{
    "project_id": 26,
    "anchor_text_config": {
      "mode": "explicit",
      "tier1": ["high volume", "precision machining", "custom manufacturing"],
      "tier2": ["high volume production", "bulk manufacturing", "large scale"]
    },
    "tiers": {
      "tier1": {"count": 12},
      "tier2": {"count": 38}
    }
  }]
}

2.4 KiB Raw Blame History