diff --git a/docs/bxl/explanation/basics.md b/docs/bxl/explanation/basics.md index 832d6b8d6578..77cf8ce3d7f7 100644 --- a/docs/bxl/explanation/basics.md +++ b/docs/bxl/explanation/basics.md @@ -67,7 +67,8 @@ instead. Querying the configured graph means that configurations have been applied to the target graph. For cquery, we require that users use a -[target universe](../../target_universe) for their query inputs. +[target universe](../../how_tos/how_to_use_target_universe) for their query +inputs. #### Aquery diff --git a/docs/bxl/target_universe.md b/docs/bxl/how_tos/how_to_use_target_universe.md similarity index 91% rename from docs/bxl/target_universe.md rename to docs/bxl/how_tos/how_to_use_target_universe.md index 81d2b077d7bc..d5e8ed71daf3 100644 --- a/docs/bxl/target_universe.md +++ b/docs/bxl/how_tos/how_to_use_target_universe.md @@ -1,15 +1,16 @@ --- -id: target_universe -title: Target Universe in BXL +id: how_to_use_target_universe +title: How to Use Target Universe in BXL --- ## BXL cquery and target universe -BXL cannot infer the [target universe](../concepts/glossary.md#target-universe) -like in the CLI (in most cases). BXL splits up cquery functions per function -(ex: `ctx.cquery().kind(...)`), with the exception of `ctx.cquery.eval(...)`, -which accepts literals exactly like in the CLI. For the `eval` query, target -universe is inferred exactly like the CLI. +BXL cannot infer the +[target universe](../../concepts/glossary.md#target-universe) like in the CLI +(in most cases). BXL splits up cquery functions per function (ex: +`ctx.cquery().kind(...)`), with the exception of `ctx.cquery.eval(...)`, which +accepts literals exactly like in the CLI. For the `eval` query, target universe +is inferred exactly like the CLI. For all other cases, take the following query as an example: diff --git a/website/sidebars.ts b/website/sidebars.ts index abbdc0ea1be2..1612e38c6683 100644 --- a/website/sidebars.ts +++ b/website/sidebars.ts @@ -176,16 +176,10 @@ export const sidebars: SidebarsConfig = { 'bxl/how_tos/how_to_handle_errors', 'bxl/how_tos/how_to_catch_building_artifacts_errors', 'bxl/how_tos/how_to_run_actions_based_on_the_content_of_artifact', + 'bxl/how_tos/how_to_use_target_universe', 'bxl/how_tos/how_to_collect_telemetry_events' ] }, - { - type: 'category', - label: 'User Guide', - items: [ - 'bxl/target_universe', - ], - }, { type: 'category', label: 'Explanation',