diff --git a/README.md b/README.md index 779c33a..28bf404 100644 --- a/README.md +++ b/README.md @@ -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) diff --git a/faq.md b/faq.md index fb541a2..ec16975 100644 --- a/faq.md +++ b/faq.md @@ -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? @@ -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? @@ -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 @@ -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: @@ -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 diff --git a/getting-started.md b/getting-started.md index 3bafa5b..27881d2 100644 --- a/getting-started.md +++ b/getting-started.md @@ -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 @@ -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 @@ -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. @@ -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. @@ -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