Skip to content

Nested inline anchors break definition lists & fail link checking #354

@bmorelli25

Description

@bmorelli25

Summary

The following syntax exists in the ES Guide:

$$$search-type$$$

`search_type`
:   (Optional, string) How [distributed term frequencies]({{wikipedia}}/Tf–idf) are calculated for [relevance scoring](query-filter-context.md#relevance-scores).

    ::::{dropdown} Valid values for `search_type`
    `query_then_fetch`
    :   (Default) Distributed term frequencies are calculated locally for each shard running the search. We recommend this option for faster searches with potentially less accurate scoring.

    $$$dfs-query-then-fetch$$$

    `dfs_query_then_fetch`
    :   Distributed term frequencies are calculated globally, using information gathered from all shards running the search. While this option increases the accuracy of scoring, it adds a round-trip to each shard, which can result in slower searches.

    ::::

The built output looks like this:

Image

What I expect:

  • Both definition list items: query_then_fetch & dfs_query_then_fetch should be within the dropdown element.
  • The anchor tag $$$dfs-query-then-fetch$$$ which does exist in the output file, should work with link checking. The current error is:
    :: fail: Documentation.Builder.Log[0] `dfs-query-then-fetch` does not exist in search-search.md. (/Users/brandon/Documents/GitHub/elasticsearch.md/docs/consistent-scoring.md:29)
    

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions