Repository navigation
Search failures at https://www.eclipse.org/openj9/docs/ #831
Description
Activity
Search does seem a bit random. For example, "codecache" finds -XX:[+|-]PrintCodeCache but not -XX:codecachetotal. The MkDocs software levels need updating, which might make a difference. Looks like some search index options were added last June: https://www.mkdocs.org/about/release-notes/.
The MkDocs levels have just been updated but this problem still exists. Needs more investigation. For example, looks like the colon (:) was until just a few days ago replaced by whitespace during a search: squidfunk/mkdocs-material#4884.
You can customize the search by using the
separator1 property in yourmkdocs.ymlconfig file.For example, here's what Material for MkDocs uses for their docs site:
plugins: - search: separator: '[\s\-,:!=\[\]()"/]+|(?!\b)(?=[A-Z][a-z])|\.(?!\d)|&[lg]t;'
And here's the config 2 we used to improve search on our Renovate docs site:
plugins: - search: separator: '[\s\-,:!?=\[\]()<>{}"/\\]+|\.(?!\d)|&[lg]t;'
Before you apply any of these configs, read the Material for MkDocs manual, and get help from somebody who knows their regex. 😉
Footnotes
Thanks for the tips @HonkingGoose 🙂
Reacted by HonkingGooseThe Material for MkDocs maintainer is working on better search, see this issue:
There's also a PR with the new search as preview on that repository.
When searching to see whether OpenJ9 supports some JVM arg, the search box at the top of the page often fails, reporting "No matching documents" even when the arg is in fact supported and documented.
A recent example is -XX:ParallelGCThread
Searching with the full value shows "No matching documents", which does not change if I remove the "-" or remove "-XX:"
But if I start with just "Parallel" in the search box (no quotes), then '-XX:ParallelGCThread' is shown as a choice, among other JVM args containing the string 'parallel'.