I looked into options for resolving that and the easiest solution I found
is to exclude all md files from search for all Icerbrg documentation
versions, except for the just one, nightly probably being the best
candidate as it is a defult landing version of documentation. That can be
achieved by adding a mkdocs-material's YAML frontmatter property to md
files during the site build process:

--- 
<https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-search/#__codelineno-6-2>search:
<https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-search/#__codelineno-6-3>
 exclude: true 
<https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-search/#__codelineno-6-4>---



On Thu, May 14, 2026 at 1:39 AM Robin Moffatt via dev <
[email protected]> wrote:

> I agree, the current behaviour is not ideal for the end-user. The results
> don't indicate the version either so you end up with literal duplicates:
> [image: CleanShot 2026-05-14 at [email protected]]
>
> On Thu, 14 May 2026 at 07:17, Max Konstantinov <
> [email protected]> wrote:
>
>> Hi all,
>>
>>
>> Problem statement
>> If you open https://iceberg.apache.org/
>> <https://urldefense.com/v3/__https://iceberg.apache.org/__;!!Ayb5sqE7!oRqHG1ZbjiQCzTf4geY7acwJ5T348ItdBhCxA93gVPFAC7C6I6nQHtkpxvkEN1zEBSfkq7BdqNaJnYBf6wfaUGD1HAZo$>
>>  and
>> use a search bar to look for anything, ex: "rewrite", you get duplicated
>> results because results(ex: rewrite_table_path) are found multiple times,
>> once for each version of Iceberg documentation(1.4 to 1.10), all these
>> versions are present on the website under the previous section in the
>> navigation tab and all of them are indexed.
>>
>> Question
>> Is that a bug and does it need to be addressed? I have a suggestion on
>> how to approach this.
>>
>> Notes
>> Iceberg's site build uses mkdocs and mkdocs-material which in turn
>> utilize lunrjs for search.
>>
>>
>> Max.
>>
>
>
>

Reply via email to