The itch
Today I spotted something odd in a new browser.

You donāt see it, yet? Totes understandable. I noticed only because this is a fresh install and I havenāt yet brought in all my junk. Here, Iāll help.

Brave uses a lot of source code from the Chromium project. Thatās the same open source project from where Google Chrome gets much of its source code. In Chromium and Chrome, the UI for bookmarks uses stars. Braveās UI uses, well, bookmarks. And, if Iām being fussy, the button is no longer in the address bar. In Brave, itās been moved out and to the side.
The problem was a tiny thing. But my curiosity about how the Brave project works won out, and I decided to peek under the hood. There was also a chance that the discrepancy had gone unnoticed for a long time. Many people import their bookmarks from another browser, and if you do that, you wonāt see the broken message. At minimum, I could create an Issue and document this.
Why we peek
From a year of running āGetting Started in Open Sourceā workshops, Iāve learned there are many motivations for people who start contributing open source. One of those reasons is tracking down problems with something we use.
I am curious about how stuff I use is made: the process and the implementation. But itās typically something being broken that actually drives me towards the source code. Monica, Buttercup, and Gatsby: all open source, all products where I could scratch my own itch. (Thatās a metaphor, scratching actual itches is not recommended. Scratching irritates the skin more, and makes the itch worse. Itās a vicious cycle.)
I wanted to know about how the Brave project was set up. Updating a string needs knowledge of the process more than it needs knowledge of the stack. So, if I could find out how, Iād put in a fix.
Pulling back the curtain a bit
That we can get visibility into the making of products we use is a wonderful reason for certain products to be open sourced.
My process of digging typically looks like this:
- Find out where Brave keeps its source code: Going to their website would have been a good choice. Itās probably in the footer, theyāre very vocal about the browser being open-sourced. But I was lazy, I used a search engine. I figured theyād either be using Github or GitLab, so I started with ābrave githubā, and the first result got me to their GitHub organization.
- Which repo? The Brave team have 150 public repos! But they, very helpfully, pinned the important ones. Right up top is the repository for the Brave browser.
- Search for the string in the repo: I looked for the string in the repo code. Seemed the fastest way to find the right part of the source.

But there was no result. This is me baffled. Where do they keep those messages?

But, there were hits for that string in Issues.
- Find existing Issues: When possible, donāt open duplicate Issues.

So I bite. The first hit is irrelevant. But the second one is right on the money šø.

I see that a collaborator opened Issue #2494 for exactly the same reason Iād come here. Wonderful!
The Issue description is very thorough, and even includes screenshots. Bloody exemplary šÆ. Sometimes we skip screenshots, when something seems trivial, even when we know itās best practice for anything that involves UI. But here is a great example why itās worth following open source development best practices. Over a year after the collaborator created this Issue, Iām being helped out by their efforts.
Iām def not the first person to think about tracking this down. So much for āunnoticedā š. But the Issue is from way back in late 2018. Has it stalled?
Progress of Issue #2494, in short
As I scroll down, I see that the Issue was added to a backlog tracker, deprioritized, reprioritized, moved around a project board. I learned that this repo uses the Projects feature to organize its work.
- Within a few months of the issue being opened, another collaborator commented the copy with which to replace the obsolete text: āTo bookmark pages, click the bookmarks button next to the address bar.ā.
- A collaborator suggested also changing the favicon for the Bookmarks Manager. Issue screenshot shows it to be a star, like Chromium. Iām seeing the same in Brave 1.4.96.
- A contributor confirmed the copy.
- Over a year after the issue was opened, yet another collaborator made a PR that fixed the issue. The PR was made in a different repo, brave-core. The string lives there, in this file. Seems like brave-core holds all the changes that turn Chromium into Brave.
If youāre looking to jump in
I usually give people 3 things with which to get started in an open source project.
- Code of Conduct: I couldnāt find a Code of Conduct for brave-browser. There was one for brave-muon (from before they switched to basing off of Chromium). Someone even tried to open a discussion about it in a diffent repo.
- Contributor guide: These should have everything a new contributor needs to get started. Here is Braveās. Itās quite thorough: it suggests different ways to contribute (people are often surprised by how many there can be), process guidance (donāt assume people know your branching conventions, without being told š), etc.
- Good first issues: This is a label that is conventionally added to Issues that need less insider knowledge to help resolve. Use this filter to see open Issues in the brave-browser repo that are marked as good for first timers.
š¬ Thanks for reading all the way through! Let me know what you think. You can (at)me on Mastodon or Twitter.