Skip to content

[pull] main from brave:main #7

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
pull wants to merge 2 commits into
base: main
Choose a base branch
from
+14 −30
Open

[pull] main from brave:main #7

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
9102101
Remove beta label for Goggles
remusao Jan 26, 2026
e83e5c2
Merge pull request #55 from brave/remove-beta-label
remusao Apr 22, 2026
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
1 change: 0 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,6 @@ Want to learn more about the motivation for Goggles? Check out the [Goggles whit
* [Can Goggles ownership be transferred?](https://github.com/brave/goggles-quickstart/blob/main/faq.md#can-goggles-ownership-be-transferred)
* [Do Goggles contribute to polarization?](https://github.com/brave/goggles-quickstart/blob/main/faq.md#do-goggles-contribute-to-polarization)
* [What’s next for Goggles?](https://github.com/brave/goggles-quickstart/blob/main/faq.md#do-goggles-contribute-to-polarization)
* [Why is Goggles in Beta?](https://github.com/brave/goggles-quickstart/blob/main/faq.md#why-is-goggles-in-beta)
* [Why is a particular page not recoverable with Goggles?](https://github.com/brave/goggles-quickstart/blob/main/faq.md#why-is-a-particular-page-not-recoverable-with-goggles)
* [Can anyone create a Goggle or is it only for developers?](https://github.com/brave/goggles-quickstart/blob/main/faq.md#can-anyone-create-a-goggle-or-is-it-only-for-developers)
* [How can I discover new Goggles?](https://github.com/brave/goggles-quickstart/blob/main/faq.md#how-can-i-discover-new-goggles)
Expand Down
26 changes: 6 additions & 20 deletions faq.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ the examples functional.
Goggles are by definition open-source, however, the authors can choose any
license they please. People forking a Goggle are subjected to the terms of its
license as any other open-source piece of software.


## Why can’t I apply multiple Goggles at the same time?

Expand Down Expand Up @@ -81,7 +81,7 @@ case of success:
* All transfers will be logged and publicly accessible for transparency and traceability (coming soon).

Note, there are no guarantees of the truthfulness or accuracy of any Goggle
outside the reputation of their creators/maintainers.
outside the reputation of their creators/maintainers.


## Do Goggles contribute to polarization?
Expand All @@ -92,7 +92,7 @@ fact, we believe they can help combat these issues.
First, Goggles does not always have to be about polarizing topics such as
politics. Of course, this kind of Goggles will exist and be popular. For
instance the team at [Allsides](https://allsides.com/) have already built
multiple addressing different political leanings.
multiple addressing different political leanings.

However, we believe that most Goggles will deal with specific use-cases that
are too niche to be properly covered by an all-purpose search engine, which of
Expand Down Expand Up @@ -127,11 +127,9 @@ respected, regardless of personal opinions.

## What’s next for Goggles?

Goggles is in beta, and subjected to evolution depending on the most important
factor: the community of creators.

We believe that the current state is enough to be open, but we’ll closely
monitor feedback.
Goggles is subjected to evolution depending on the most important factor: the
community of creators. We believe that the current state is enough to be open,
but we’ll closely monitor feedback.

There are some things that we already know need to be improved or expanded, for
which we welcome the community to contribute, including:
Expand All @@ -151,18 +149,6 @@ which we welcome the community to contribute, including:
titles, descriptions, or content.


## Why is Goggles in Beta?

Goggles represents a fundamental push towards algorithmic transparency and
openness in search. The community plays a crucial role in this vision. While in
beta, we will keep Goggles on a dedicated tab at
https://search.brave.com/goggles. Once out of beta it will be integrated into
the main search interface.

Goggles, especially while in beta, is a living project. It will evolve thanks
to the feedback and needs of the community of builders.


## Why is a particular page not recoverable with Goggles?

With Goggles, it’s straightforward to implement custom search engines like a
Expand Down
17 changes: 8 additions & 9 deletions getting-started.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -85,7 +85,7 @@ express complex reranking functions:

To update a Goggle, you must resubmit the Goggle URL in
https://search.brave.com/goggles/create. This will trigger a re-fetch of the
updated Goggle source, and then make it available on Brave Search.
updated Goggle source, and then make it available on Brave Search.

It’s important to know that Brave Search does not maintain a version history of
Goggles, which means the author is solely responsible for the content of their
Expand All @@ -102,10 +102,10 @@ URL in https://search.brave.com/goggles/create.
## Learn by example

We believe it’s best to learn by example—this is why we created some Goggles
for the beta release, strictly for educational purposes, they are authored by
“Goggles 101” and hosted in this repository under the [goggles folder](./goggles).
Any Goggle not hosted by Brave is, of course, not affiliated with Brave in any
way.
for the release, strictly for educational purposes, they are authored by
“Goggles 101” and hosted in this repository under the [goggles
folder](./goggles). Any Goggle not hosted by Brave is, of course, not
affiliated with Brave in any way.

These Goggles are best-effort and as-is. We will not actively maintain them, as
their sole purpose is to showcase some basic use-cases of what is possible with
Expand Down Expand Up @@ -135,7 +135,7 @@ Creating Goggles is simple. However, they often need some fine-tuning to shine.
The typical flow is to create the first set of instructions and then have a
test set to evaluate the effect it has on the ranking. You will probably see
some odd results and further instructions will be needed. Rinse and repeat is
the name of the game.
the name of the game.

To make this task a little less tedious, we provide some explanations on the
results that have been affected by the instructions in the Goggle.
Expand All @@ -147,7 +147,7 @@ This might help you in the process.

## Sharing a Goggle with the world

Any Goggle you create can either be `private` or `public`.
Any Goggle you create can either be `private` or `public`.

If it is `private`, it will not be discoverable, and will only be accessible to
those who know the Goggle URL.
Expand All @@ -174,8 +174,7 @@ Goggles, please refer to the [Goggles quickstart
guide](./goggles/quickstart.goggle).

Certain Goggles that become very popular might end up being displayed on the
[discovery page’s](https://search.brave.com/goggles/discover) Popular Goggles section. For the beta launch, we’re only
displaying the educational Goggles.
[discovery page’s](https://search.brave.com/goggles/discover) Popular Goggles section.

However, the preferred option to discover Goggles is to find them directly from
the creator on their own channels. Sharing your Goggle is as simple as building
Expand Down