Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/batch-changes/batch-spec-templating.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
Understand how to use templating to make your batch changes more powerful.
</p>

[Certain fields](#fields-with-template-support) in a [batch spec YAML](/batch-changes/batch-spec-yaml-reference) support templating to create even more powerful and performant batch changes. Templating in a batch spec uses the delimiters `${{` and `}}`. Inside the delimiters, [template variables](#template-variables) and [template helper functions](#template-helpers-functions) may be used to produce a text value.
[Certain fields](#fields-with-template-support) in a [batch spec YAML](/batch-changes/batch-spec-yaml-reference) support templating to create even more powerful and performant batch changes. Templating in a batch spec uses the delimiters `${{` and `}}`. Inside the delimiters, [template variables](#template-variables) and [template helper functions](#template-helper-functions) may be used to produce a text value.

## Example batch spec with templating

Expand Down Expand Up @@ -286,7 +286,7 @@ steps:
container: golang
```

Combine the [template helper functions](#template-helpers-functions) with the helper functions built into Go's [`text/template`](https://pkg.go.dev/text/template) library:
Combine the [template helper functions](#template-helper-functions) with the helper functions built into Go's [`text/template`](https://pkg.go.dev/text/template) library:

```yaml
changesetTemplate:
Expand Down
2 changes: 1 addition & 1 deletion docs/batch-changes/batch-spec-yaml-reference.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -367,7 +367,7 @@ The value the output should be set to.

## `steps.outputs.<name>.format`

The format of the corresponding [`steps.outputs.<name>.value`](#outputs-value). When this is set to something other than `text`, it will be parsed as the given format.
The format of the corresponding [`steps.outputs.<name>.value`](#stepsoutputsnamevalue). When this is set to something other than `text`, it will be parsed as the given format.

Possible values: `text`, `yaml`, `json`. Default is `text`.

Expand Down
2 changes: 1 addition & 1 deletion docs/batch-changes/configuring-credentials.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -304,7 +304,7 @@ When Sourcegraph is configured to [clone repositories using SSH via the `gitURLT

EXPERIMENTAL: Using GitHub Apps to authenticate Batch Changes is currently experimental, and there may still be some rough edges.

GitHub apps follow the same concepts as [personal and global access tokens](#types-of-access-tokens-used-by-batch-changes).
GitHub apps follow the same concepts as [personal and global access tokens](#types-of-credentials-used-by-batch-changes).

### Limitations

Expand Down
2 changes: 1 addition & 1 deletion docs/batch-changes/create-a-batch-change.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ The library contains examples that you can apply right into your batch spec if y

### Executing your batch spec

When the spec is ready to run, ensure the [preview](/batch-changes/create-a-batch-change#previewing-workspaces) is up to date and then click **Run batch spec**. This takes you to the execution screen. On this page, you see:
When the spec is ready to run, ensure the [preview](/batch-changes/create-a-batch-change#previewing-batch-spec-and-workspaces) is up to date and then click **Run batch spec**. This takes you to the execution screen. On this page, you see:

- Run statistics at the top
- All the workspaces, including status and diff stat, in the left panel
Expand Down
2 changes: 1 addition & 1 deletion docs/batch-changes/handling-errored-changesets.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ src batch apply -f YOUR_BATCH_SPEC.batch.yaml
more information on these commands.
</Callout>

Examples of errors that requires [manual retrying](#manual-retrying-by-re-applying-the-batch-change-spec) are as follows:
Examples of errors that requires [manual retrying](#manual-retrying-of-errored-changesets) are as follows:

- No [Batch Changes credentials](/batch-changes/configuring-credentials) have been set up for the affected code host
- The configured code host connection needs a different type of credentials (for example, with SSH keys)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Whenever [Sourcegraph CLI](/cli/) re-executes the same batch spec, it checks a *
Whether a cached result can be used is dependent on multiple things:

- The repository's default branch's revision didn't change (because if new commits have been pushed to the repository, re-executing the `steps` might lead to different results)
- The `steps` themselves didn't change, including all their inputs, such as [`steps.env`](/batch-changes/batch-spec-yaml-reference#environmentarray), and the `steps.run` field (which can change between executions if it uses [templating](/batch-changes/batch-spec-templating) and is dynamically built from search results)
- The `steps` themselves didn't change, including all their inputs, such as [`steps.env`](/batch-changes/batch-spec-yaml-reference#stepsenv), and the `steps.run` field (which can change between executions if it uses [templating](/batch-changes/batch-spec-templating) and is dynamically built from search results)

That also means that [Sourcegraph CLI](/cli/) can use cached results when re-executing a **changed batch spec**, as long as the changes didn't affect the `steps` and the results they produce.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -48,5 +48,5 @@ Any matches that return values over a 100 characters will be truncated. This is

### Regular expression capture group resources

- [Example regular expressions for common use cases](/code-insights/references/common-use-cases#automatic-version-and-pattern-tracking)
- [Example regular expressions for common use cases](/code-insights/references/common-use-cases#versions-and-patterns)
- [General additional capture groups documentation](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions/Groups_and_Ranges)
2 changes: 1 addition & 1 deletion docs/code-insights/explanations/code-insights-filters.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ If you combine both filters, the inclusion pattern will be applied first, then t

### `context:` Query-based search context filters

You can use a [query-based search context](/code-search/working/search-contexts#beta-query-based-search-contexts) to filter your insights to only results matching repositories that match the `repo:` or `-repo:` filter of the query-based context.
You can use a [query-based search context](/code-search/working/search-contexts#query-based-search-contexts) to filter your insights to only results matching repositories that match the `repo:` or `-repo:` filter of the query-based context.

You can use this to filter multiple insights to a group of repositories that need only be maintained in one location. When you update a context that's being used as a filter, the next time you load the page, the filtered insight will reflect the updated context.
As with explicit `repo:` filters, only repository regex expressions are allowed: you cannot specify repository revisions or predicate filters.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Click "Create new dashboard" in the top right corner and name your dashboard. Da

## 3. Select a visibility level

Set a visibility level for your dashboard. Dashboards [respect insights' permissions](/code-insights/explanations/viewing-code-insights#dashboard-visibility-respects-insights-visibility), so don't create an organization-shared dashboard if you have private insights you want to attach to it.
Set a visibility level for your dashboard. Dashboards [respect insights' permissions](/code-insights/explanations/viewing-code-insights#dashboard-visibility), so don't create an organization-shared dashboard if you have private insights you want to attach to it.

- Private: visible only to you
- Shared with [an organization](/admin/organizations): visible to everyone in the organization
Expand Down
4 changes: 2 additions & 2 deletions docs/code-insights/how-tos/filtering-an-insight.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -28,9 +28,9 @@ Examples:

### 3. Or, filter to include a reusable group of repositories using a query-based search context

In the `context:` field of the filter panel, you can use a [query-based search context](/code-search/working/search-contexts#beta-query-based-search-contexts) to filter your insights to only results matching repositories that match the query-based context's `repo:` filter.
In the `context:` field of the filter panel, you can use a [query-based search context](/code-search/working/search-contexts#query-based-search-contexts) to filter your insights to only results matching repositories that match the query-based context's `repo:` filter.

First, if you haven't already created a search context, create a [query-based search context](/code-search/working/search-contexts#beta-query-based-search-contexts). You can define any group of repos using the syntax `repo:(^github\.com/sourcegraph/sourcegraph$|^github\.com/sourcegraph/about$...)`.
First, if you haven't already created a search context, create a [query-based search context](/code-search/working/search-contexts#query-based-search-contexts). You can define any group of repos using the syntax `repo:(^github\.com/sourcegraph/sourcegraph$|^github\.com/sourcegraph/about$...)`.

Then, in the context field, reference the search context's name, usually `@owner/name-of-context`.

Expand Down
2 changes: 1 addition & 1 deletion docs/code-insights/language-insight-quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Get started and create your first [language code insight](/code-insights/) in 5

## Introduction

> This quickstart guide assumes that **you have already completed [step 1, enabling the feature flag](/code-insights/quickstart#1-enable-the-experimental-feature-flag)**, on the main code insights quickstart guide.
> This quickstart guide assumes that **you have already completed [step 1, enabling the feature flag](/code-insights/quickstart#1-if-need-be-enable-the-experimental-feature-flag)**, on the main code insights quickstart guide.

In this guide, you'll create a Sourcegraph language code insight that shows the percentage of lines of code in a repository by language.

Expand Down
2 changes: 1 addition & 1 deletion docs/code-insights/references/common-use-cases.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Here are some common use cases for Code Insights and example data series queries

For all use cases, you can also explore your insight by [filtering repositories in real time](/code-insights/how-tos/filtering-an-insight) or add any [Sourcegraph search filter](/code-search/queries/language#search-pattern) to the data series query to filter by language, directory, or content. Currently, the sample queries using commit and diff searches are only supported for insights running over explicit lists of specific repositories.

_The sample queries below make the assumption you [do not want to search fork or archived](/code-insights/references/common-reasons-code-insights-may-not-match-search-results#not-including-fork-no-and-archived-no-in-your-insight-query) repositories. You can include those flags if you do._
_The sample queries below make the assumption you [do not want to search fork or archived](/code-insights/references/common-reasons-code-insights-may-not-match-search-results#for-versions-pre-340-not-including-forkno-and-archivedno-in-your-insight-query) repositories. You can include those flags if you do._

## Popular

Expand Down
2 changes: 1 addition & 1 deletion docs/cody/capabilities/agentic-context-fetching.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@ Agentic context fetching is enabled by default. It uses LLM reflection and basic

You can disable agentic context in your extension settings using `cody.agenticContext`.

Terminal access for Enterprise users is disabled by default. To enable it, set the `agentic-chat-cli-tool-experimental` feature flag [terminal access](#terminal-commands).
Terminal access for Enterprise users is disabled by default. To enable it, set the `agentic-chat-cli-tool-experimental` feature flag [terminal access](#terminal-access).

## MCP support

Expand Down
2 changes: 1 addition & 1 deletion docs/cody/capabilities/chat.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -88,7 +88,7 @@ Image upload support varies by client. Check the [feature parity reference](/cod

Cody allows you to select the LLM you want to use for your chat, which is optimized for speed versus accuracy. Enterprise users with the new [model configuration](/cody/enterprise/model-configuration) can use the LLM selection dropdown to choose a chat model.

You can read about these supported LLM models [here](/cody/capabilities/supported-models#chat-and-commands).
You can read about these supported LLM models [here](/cody/capabilities/supported-models#chat-and-prompts).

## Smart Apply and Execute code suggestions

Expand Down
2 changes: 1 addition & 1 deletion docs/cody/clients/cody-with-sourcegraph.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ The chat interface with your Code Search queries opens parallel to your query se

## Chat with Cody on the web interface

The feature set for the Cody chat is the same as the IDE extensions. Your previous chats can be viewed from the **History** tab. Claude 3.5 Sonnet is selected as the default chat model. You can change this LLM model based on your use case to optimize speed, accuracy, or cost. Enterprise users with the new [model configuration](/cody/enterprise/model-configuration) can use the LLM selection dropdown to choose a chat model. You can read about these supported LLM models [here](/cody/capabilities/supported-models#chat-and-commands).
The feature set for the Cody chat is the same as the IDE extensions. Your previous chats can be viewed from the **History** tab. Claude 3.5 Sonnet is selected as the default chat model. You can change this LLM model based on your use case to optimize speed, accuracy, or cost. Enterprise users with the new [model configuration](/cody/enterprise/model-configuration) can use the LLM selection dropdown to choose a chat model. You can read about these supported LLM models [here](/cody/capabilities/supported-models#chat-and-prompts).

To help you automate your key tasks in your development workflow, you get **[Prompts](/cody/capabilities/prompts)**. If you are a part of an organization on Sourcegraph.com or a self-hosted Sourcegraph instance, you can view these pre-built Prompts created by your teammates. On the contrary, you can create your Prompts via the **Prompt Library** from your Sourcegraph instance.

Expand Down
2 changes: 1 addition & 1 deletion docs/cody/clients/install-jetbrains.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -159,7 +159,7 @@ Enterprise users can leverage the full power of the Sourcegraph search engine as

<Callout type="info">
{' '}
Read more about [Context fetching mechanisms](/cody/core-concepts/context/#context-fetching-mechanism)
Read more about [Context fetching mechanisms](/cody/core-concepts/context#cody-context-fetching-features)
in detail.
</Callout>

Expand Down
2 changes: 1 addition & 1 deletion docs/cody/clients/install-vscode.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -195,7 +195,7 @@ Enterprise users can use the full power of the Sourcegraph search engine as Cody

<Callout type="info">
{' '}
Read more about [Context fetching mechanism](/cody/core-concepts/context/#context-fetching-mechanism)
Read more about [Context fetching mechanism](/cody/core-concepts/context#cody-context-fetching-features)
in detail.
</Callout>

Expand Down
Loading