Skip to contents

Per-source context for a sitemap-index child (ADR-009 §1, §12.1 invariant)

Source: R/ruleset-context.R
ruleset_context_for_child.Rd

Expresses the per-source invariant that a sitemap-index child inherits nothing implicitly: this helper takes no parent context, so a child's context can only be established by its own evidence. The defaults encode a child with no submission facts (submission_channel = "absent"), found as an index child (discovery_provenance = "index_child"), no bound property, and no authority evidence (authority_evidence = "absent"). A caller supplies the child's own evidence via the arguments.

Usage

ruleset_context_for_child(
  submission_channel = "absent",
  discovery_provenance = "index_child",
  property_scope = NA_character_,
  authority_evidence = "absent"
)

Arguments

submission_channel

One of search_console_api, webmaster_tools, user, import, or absent (default). "discovered" is rejected.

discovery_provenance

One of organic (default), robots_txt_reference, supplied, guessed_path, index_child, or archive_derived.

property_scope

The verified property/site string (a URL) or NA (default).

authority_evidence

One of absent (default), verified_property_set, target_host_robots_reference, same_location_default, or conflicting.

Value

An object of class sitemapr_ruleset_context built solely from the child's own evidence.

Details

This is the invariant-respecting context primitive only; it does not evaluate scope or authority (§12.2; S4/S5 own those). Because there is no parent parameter, a submitted or verified parent index cannot confer scope or authority on a child by construction.

See also

ruleset_context() for the general constructor.

Examples

# A child with no evidence of its own: nothing is inherited from the parent.
ruleset_context_for_child()
#> $submission_channel
#> [1] "absent"
#> 
#> $discovery_provenance
#> [1] "index_child"
#> 
#> $property_scope
#> [1] NA
#> 
#> $authority_evidence
#> [1] "absent"
#> 
#> attr(,"class")
#> [1] "sitemapr_ruleset_context"

# A child that carries its own verified-property evidence.
ruleset_context_for_child(
  property_scope = "https://cdn.example.com/",
  authority_evidence = "verified_property_set"
)
#> $submission_channel
#> [1] "absent"
#> 
#> $discovery_provenance
#> [1] "index_child"
#> 
#> $property_scope
#> [1] "https://cdn.example.com/"
#> 
#> $authority_evidence
#> [1] "verified_property_set"
#> 
#> attr(,"class")
#> [1] "sitemapr_ruleset_context"