From 8f9b236d556f5a83f9afbdebf424adaaedc2193f Mon Sep 17 00:00:00 2001 From: Saksham Date: Thu, 12 Nov 2026 15:19:11 +0100 Subject: [PATCH] docs(search): document plain search and all search shortcuts * explain where a plain search looks and that every word must match * note that DOIs and report numbers can be pasted as they are * list every CDS search shortcut with a working example * explain how to request a new shortcut through a support ticket * remove the _exists_ example, which is restricted to administrators Co-Authored-By: Claude Opus 5.5 --- docs/search/search.md | 43 ++++++++++++++++++++++++++++++------------- 1 file changed, 30 insertions(+), 13 deletions(-) diff --git a/docs/search/search.md b/docs/search/search.md index 98964b6..871aa40 100644 --- a/docs/search/search.md +++ b/docs/search/search.md @@ -81,7 +81,11 @@ Example: - `open science` -This type of search looks for the words you enter. +This type of search looks for the words you enter in the main parts of a record: title, creators and contributors, description, subjects, identifiers and DOI, resource type, communities, and CERN fields such as experiment, accelerator or department. You don't need to know which field a word is in. For example, `thesis Mobius` finds theses with Mobius as an author, and `CERN Education` finds records of a community with that name. + +Records that contain all your words come first, and records where the words appear together as a phrase rank higher still. Records that contain only some of the words are still listed after them. + +You can also paste a DOI or a report number as it is, for example `10.17181/CERN.ABCD.1234` or `CERN-THESIS-2021-078`. If you want to require both words, use either `+` or `AND`. @@ -136,13 +140,35 @@ Examples: | `description:policy` | searches in the description | | `language:en` | searches for records in English | | `publication_date:2024-01-01` | searches for a specific publication date | -| `doi:"10.17181/example-doi"` | searches for a [DOI](../glossary.md#doi) | +| `contributor:Smith` | searches for a contributor name | +| `affiliation:CERN` | searches for a creator affiliation | +| `subject:"particle physics"` | searches in the subjects | +| `type:thesis` | searches for a [resource type](../glossary.md#resource-type) by name | +| `resource_type.id:publication-dissertation` | searches for a resource type by its identifier | +| `community:"CERN Research"` | searches for records in a community, by community name | +| `community.id:cern-research` | searches for records in a community, by the community identifier shown in its address | +| `doi:10.17181/example-doi` | searches for a [DOI](../glossary.md#doi) | | `cds:12345` | searches for a CDS identifier | -| `cdsrn:CERN-THESIS-2021-078` | searches for a CDS [report number](../glossary.md#report-number) | +| `aleph:000725622CER` | searches for an Aleph identifier | +| `cdsrn:CERN-THESIS-2021-078` | searches for a CDS [report number](../glossary.md#report-number) (`report_number:` also works) | +| `apprn:CERN-EP-2026-001` | searches for an approval report number | +| `identifier:CERN-THESIS-2021-078` | searches all identifiers of a record | +| `inspire:1296353` | searches for a related INSPIRE record (`inis:`, `indico:`, `edms:`, `hal:` and `archive:` work the same way) | | `experiment:ATLAS` | searches for an experiment | +| `accelerator:LHC` | searches for an accelerator | +| `beam:H8` | searches for a beam | | `department:EP` | searches for a department | +| `programme:"Doctoral Student"` | searches for a programme | +| `committee:SPSC` | searches for a committee | +| `project:HL-LHC` | searches for a project | +| `study:FCC` | searches for a study | +| `facility:HiRadMat` | searches for a facility | +| `meeting:"LEMON weekly meeting"` | searches for a meeting by its title | -When you search for a DOI, put the DOI value in double quotes. +Most field names also work in the plural, for example `experiments:ATLAS`. For experiments, accelerators, beams, departments, programmes and committees, add `.id` to search by the identifier instead of the name, for example `experiment.id:atlas`. + +!!! tip "Missing a search shortcut?" + If you often search for a kind of information that has no field name in this list, or a search does not find a record you expect, [open a request with CDS Support](https://cern.service-now.com/service-portal?id=service_element&name=CDS-Service). Include the search you typed, a link to the record you expected to find, and where the information appears in that record. ### Combine different query types @@ -185,15 +211,6 @@ Rules to remember: - Mixed brackets such as `[}` let you include the start value and exclude the end value. - You can use `*` for an open-ended range. -### Search for missing values - -You can search for records that have, or do not have, a value in a field. - -Examples: - -- `_exists_:metadata.creators` -- `NOT _exists_:metadata.additional_titles` - ### Other supported advanced syntax CDS also supports several more advanced query types: