Agree with Russell that doc navigation and search should be scoped to a version.
E.g., Flink: https://nightlies.apache.org/flink/flink-docs-release-2.2/ Restructuring the doc site might be a good idea. On Thu, May 14, 2026 at 10:01 AM Kevin Liu <[email protected]> wrote: > mkdocs-exclude-search (https://github.com/chrieke/mkdocs-exclude-search) > seems promising > > We can try something like this to exclude all the versioned paths: > ``` > plugins: > - search > - exclude-search: > exclude: > - "*/[0-9]*/**" > ``` > > Note that nightly and latest are symlinks. > > > > > On Thu, May 14, 2026 at 9:54 AM Kevin Liu <[email protected]> wrote: > >> +1 to only indexing the latest/nightly >> mkdoc is using the `search` plugin [1]. And like you mentioned, we can >> use its `exclude ` property to configure exclusion paths. >> >> >> > Is there a way we can add a Version dropdown to the search? "Latests, >> 1.11, etc ...." >> >> I've looked into this before, the best solution I found is to migrate >> over to `mike` (see the tracking issue >> https://github.com/apache/iceberg/issues/14521) It's a lot of work >> though and I didn't want to risk breaking the site. >> >> Best, >> Kevin Liu >> >> >> [1] >> https://github.com/apache/iceberg/blob/87a7e4b13470b238e86872e5b194b80c3a89a80f/site/mkdocs.yml#L51 >> [2] >> https://squidfunk.github.io/mkdocs-material/plugins/search/#meta.search.exclude >> >> >> >> On Thu, May 14, 2026 at 9:33 AM Max Konstantinov < >> [email protected]> wrote: >> >>> That was my first idea too. I did some research and it seems it will be >>> more complicated to implement and might require an overhaul of the site >>> build process or/and site structure. Let me look into that again and get >>> back with an overview of potential changes. >>> >>> On Thu, May 14, 2026 at 9:13 AM Russell Spitzer < >>> [email protected]> wrote: >>> >>>> Is there a way we can add a Version dropdown to the search? "Latests, >>>> 1.11, etc ...." >>>> >>>> On Thu, May 14, 2026 at 10:26 AM Max Konstantinov < >>>> [email protected]> wrote: >>>> >>>>> 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. >>>>>>> >>>>>> >>>>>> >>>>>>
