# I'm afraid the searching of the documentation needs a bit of work

**URL:** <https://discourse.julialang.org/t/im-afraid-the-searching-of-the-documentation-needs-a-bit-of-work/61860>\
**Category:** General Usage\
**Created:** [May 26, 2021, 2:40pm UTC](https://discourse.julialang.org/t/im-afraid-the-searching-of-the-documentation-needs-a-bit-of-work/61860 "2021-05-26T14:40:39Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![PetrKryslUCSD](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/petrkryslucsd/32/215825_2.png) [@PetrKryslUCSD](https://discourse.julialang.org/u/PetrKryslUCSD)\
**Post date:** [May 26, 2021, 2:40pm UTC](https://discourse.julialang.org/t/im-afraid-the-searching-of-the-documentation-needs-a-bit-of-work/61860/1 "2021-05-26T14:40:39Z")

</div>

![image](https://global.discourse-cdn.com/julialang/original/3X/c/4/c43079158c8e5cef3b18f62ebefe2851328d79f7.png)  
Clearly, I would have appreciated some links that actually refer to `Manifest.toml`. The first one does not, at all.

---

<div class="post-metadata">

**Author:** ![paulmelis](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/paulmelis/32/35063_2.png) [@paulmelis](https://discourse.julialang.org/u/paulmelis)\
**Post date:** [May 26, 2021, 2:55pm UTC](https://discourse.julialang.org/t/im-afraid-the-searching-of-the-documentation-needs-a-bit-of-work/61860/2 "2021-05-26T14:55:56Z")

</div>

Somewhat relevant in this context: I noticed some time ago that Documenter.jl by default has an option to produce suitable markdown files for processing using MkDocs. Especially with the [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/getting-started/) theme this could potentially produce a very nice looking website with good search (including page summaries showing search hits). At least, that’s my experience with many sites that are based on MkDocs, including a few we write and publish ourselves.

However, I tried the conversion for Julia at some point, but found the search results in MkDocs to be really suboptimal. I didn’t investigate if this was due to poor indexing by MkDocs itself or if there was an issue with Julia documentation source files.

But the current list of search results is indeed not as good as it can be. Having a summary (showing the search terms in context) per hit would help already, I suspect.

---

<div class="post-metadata">

**Author:** ![paulmelis](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/paulmelis/32/35063_2.png) [@paulmelis](https://discourse.julialang.org/u/paulmelis)\
**Post date:** [May 26, 2021, 3:01pm UTC](https://discourse.julialang.org/t/im-afraid-the-searching-of-the-documentation-needs-a-bit-of-work/61860/3 "2021-05-26T15:01:40Z")

</div>

By the way, I suspect your query `Manifest.toml` gets turned into `manifest OR toml`, but you probably figured that out yourself 🙂