There should be no results for an empty search

In our current search system, when results are displayed, a snippet is shown by truncating the first 300 characters of the body or the AI-generated summary for that source. While this method provides a quick glimpse of the content, there are notable areas where it falls short in terms of relevance and user expectations:

1. Lack of Contextual Snippets: Unlike other search engines which dynamically display snippets highlighting the keywords or phrases searched by the user, our system merely shows the beginning of the document. This often fails to immediately provide the most relevant section of the text to the user.
2. Confusion Due to Summary Snippets: Our approach to prioritize summaries in search results can confuse users who, based on their experiences with other search engines, expect to see a snippet from the actual document rather than a summarized version.

Proposed Solutions

• Contextual Snippet Generation: To address the first issue, we need to research and possibly develop a method to extract snippets that specifically highlight the search terms within the context of the document. This approach ensures that the snippet shown is directly relevant to the user's query.
  • possible inspiration: how does stract does it?
• Clearer Summary Indication: For the second issue, while summaries are valuable for quick understanding, it's crucial to clearly indicate when a snippet is a summary rather than a direct excerpt. Alternatively, we could provide both—the relevant snippet and a button to view the summary. This dual approach would cater to both quick overviews and deeper context.
  • possible inspiration: all search engines have some extra options at the top right corner of the individual search result.

To see how we currently compare, you can review the difference in search result presentation across various platforms:

• Our current system: Bitcoin Search Result
• Other search engines: Google, Bing, DuckDuckGo, Stract.

Improving how we generate and present snippets will significantly enhance user experience by making search results more relevant and understandable, aligning with common user expectations and industry standards.

When filtering by author any check box indicates an OR operand not the current status of AND

The app preserves the state of the side bar when there is no search result.

Expected behaviour: When there is no search results, we should see the side bar. Also, if I previously searched for an query with result and I make a new query that doesn't return a result, the state of the side bar should be updated so that we do not see the author or sort by date side bar of the previous search.

See images below for reference.

based on https://bitcoinsearch-43t9q2gbz-btc-knowledge-base.vercel.app/

Here they are all two rows and but don't fill up the width of the div

Let's bump the default results on a page from 20 to 50 to see what the performance differences are.

The domains in the side bar should be displayed in a prettier format as indicated below:

https://bitcointalk.org == bitcointalk

https://bitcoin.stackexchange.com == Bitcoin StackExchange

https://lists.linuxfoundation.org/pipermail/bitcoin-dev/ == bitcoin dev mailing list

https://lists.linuxfoundation.org/pipermail/lightning-dev/ == lightning dev mailing list

https://btctranscripts.com/ == BTC transcripts

https://bitcoinops.org/en/ == Bitcoin Optech

Implementation of the new UI design revamp for bitcoin search
Figma link here

also addresses #79

1. Ideal is to group the mailing lists like we had before the migration from app search to elastic search
2. A initial fix would be to label posts as original posts versus replies

See here: bitcoin-dev-project/bitcoin-dev-project#27

Add a "contribute to source" action under searchbar that proceeds to modal

As a searcher I'd like to see who the author of the content is for each result to better judge its quality

Add annotation for search focus ctrl +k / cmd + k or "/"

The organization page, https://github.com/bitcoinsearch, has a broken link. Currently it is:

http://bitcoinseach.xyz/

But it should be:

https://bitcoinsearch.xyz/

(the r in "search" is missing and probably want to make the link https)

Testing an issue to see if it would appear on two project boards,

• BTC Search App, and
• The BTC Dev Project Roadmap

• / for highlight of the main searchbar
• Return key to select checkboxes or author search (maybe just map to space?)
• arrow to navigate the sidebar (though tabs work now)

The first seems like an easy addition, maybe worth discussing the other two.

Tags do not seem to be useful at the moment. Remove the tags pills in the results and the facets on the sidebar.

As a searcher, if I don't find a source that I think should be indexed, I should be able to submit the URL for review to be added.

Not sure what the copy and interface are here, but a simple form submitted to a google sheet or something like that would be enough to get started.

https://twitter.com/veronikabtc/status/1620673534791159808

When I click the arrow icon to close the result count dropdown list, it doesn't work. it flashed like it closed but it eventually stays open.

Currently, you have to manually run each lint script (e.g. npm run eslint:fix or npm run prettier:fix) to detect and fix code styles issues. This will reduce development time and performance and can lead to different linting errors being introduced (unintentionally) in the code base.

We can mitigate this by automating the process as this will reduce the scripts the developer has to run and will ensure faster development. It will also ensure that there is uniform code style in the repository.

First off - great work so far. We've very close!

Overall

• A Can someone please show me the link preview image and copy?
• B Let's name our buttons to boost accessibility
  • 
• C In terms of metadata, let's make sure we tackle all the usual OpenGraph/OG stuff. We did this well in bitcoindevs.xyz
  • Let's change preview link to "Search the depths of bitcoin's technical ecosystem"
• D When returning back to the website - let's say i'm coming off the Search Page like this one... it flashes the homepage for a few seconds and then goes to the appropriate link.
• E Remove Bitcoin Search from Secondary Product Menu
  • 

Homepage

• A Make the search input box font even brighter
  • 
• B Bottom of page CTA should be at least 2x smaller
  • 
• C Remove icons in the 3 value props and pull up the text, for example
  • 
  • 
• D The "search" button in the searchbox shouldn't be clickable if the input field is empty

Search Page

• A Same as landing page - make the search bar much brighter
  • 
• Let's keep the "showing x" results section
• B Let's increase the font of the holocat section, it's smaller than any other font we're using
  • 
• C Let's make sure that clicking a search result opens a new tab
• D Source formatting should follow Title Case
  • "Bitcoin dev mailing list" -> "Bitcoin Dev Mailing List"
  • "BTC transcripts" -> "BTC Transcripts"
  • "LN dev mailing list" -> "LN Dev Mailing List", and the like
  • If in doubt, let's use something like this, with APA https://capitalizemytitle.com/
• E When searching for something in the authors/ sources section, it doesn't remove non-relevant options. For example - as i search for "githu", i should only see sources with "githu" in the title string
  • 
• F For some reason i'm seeing duplicates when searching for a query in the Source list
  • 

Footer

• Add a Discord logo beside the Github logo in the footer
  • https://discord.gg/EAy9XMufbY
  • Should be easy to find both dark and light logo version
• Give Feedback in footer should link here
  • https://cryptpad.fr/form/#/2/form/view/3P2CsohsHOkcH7C+WdtX0-tvqjBHqXnAmz5D9yx0e04/

Feedback for Designer

• A Some of our logos look pretty invisible in dark mode - we have to design a light mode version for them. For example, Delvingbitcoin & GitHub
  • 
• B We need a different favicon for the product
  • 
• C The second image on the Landing Page should still be an image of the search page with "lightning" being the query
  • It doesn't need to be perfect or the final version of the screen - we can change it after. Just needs to be about lightning
  • 
• D This image looks unintentionally blurry. It doesn't look like you're trying to make the "newest sort" and "sources list" pop, which is the intention. Maybe darkening out or making even more fuzzy will help? Not a blocker for launch.
  • 
  • 

So close lads!

As a user, I'd like to select all docs with facets available on the results page but without searching a specific term.

For example, I'd like to see all mailing list posts by Greg Maxwell or all docs by Pieter Wuille from stack exchange.

Maybe we can do this with a collection of the pills for the domains and authors. Let's leave tags out.

Currently, our search functionality in Bitcoin Search groups results from the same source under a single initial post, which users can expand to see the rest of the posts. This feature is beneficial as it organizes information neatly and enhances user experience by decluttering the results page.

However, this grouping is only implemented for mailing list & Stack Exchange and is not yet available for other significant sources such as DelvingBitcoin and BitcoinTalk.

You can verify this behavior by searching for anything and then filter by the specific sources.

To provide a consistent and user-friendly search experience across all our platforms, I propose we extend this thread grouping feature to include all other sources. This would mean that posts from DelvingBitcoin, BitcoinTalk, and any other selected sources would also be displayed in a grouped format.

There is currently no check for errors in the code for every pull request to main on github. This requires that the reviewer manually check for these errors or check out the PR locally to review.
Hence, this can silently introduce bugs or silent errors in the app.

This can be mitigated by setting up an automated github actions workflow to check the code for errors (linting or spelling errors and later unit or e2e tests) on every pull request to main. If there are any errors, it will be flagged, thereby narrowing the workload of the reviewer as he only has to focus on the code functionality review and other parameters.

Show other links that are similar to the result

"Gnusha should be bitcoin-dev mailing list"

#114 (comment)

Rather than display as truncated snippet of text, use the generated summaries of the mailing list posts

The typeahead has a lot of fragments in its results. Can we tune it better or not display so many?

I compared our app vs Google search focusing on the layout and text of the result page on mobile. One thing that stood out to me was that Google's result text is much easier to read and the colors are vivid even in dark mode as opposed to ours.
The buttons showing the authors, dates, and the reference link at the top of the main highlighted link are too small. Please see the screenshots below

Just so you know, this is just my opinion and observation. This is a design choice so best to include the designer in this conversation.

Screenshot 1: Google

Screenshot 2: Bitcoinsearch iOS

Screenshot 3: Bitcoinsearch Android

Link to https://bitcoin-irc.chaincode.com/bitcoin-core-dev/. Text should be something like, "#bitcoin-dev IRC search"

"The thumbnail url can be determined in the front-end directly...
https://i3.ytimg.com/vi/[YOUTUBE_ID]/maxresdefault.jpg"

From @aureleoules

Let's pull those and display them online for the search results that have a YouTube media field.

If available, add a date to the result next to the author.

we have the file (Homefooter.tsx), it just isn't rendered

"Support for selecting multiple authors. The checkbox UI suggests that it should already be possible but once you pick one the others disappear"

https://twitter.com/shesek/status/1628431264700108802

On the backend, I've boosted original_posts from the mailing list but I also think we can do a better job ordering the groupings of threads.

Let's display the original_post as the parent of the grouping and if there are no original_posts, let's go in date order which you can pull from the created_at field OR you can pop the resource identifier off after the last slash (e.g. as in 018045 of https://lists.linuxfoundation.org/pipermail/bitcoin-dev/2020-July/018045.html) and use that number to order them (lowest first).

The repetition of the mailing list makes the results noisey.

Let's only show the original post and show just the titles of the thread urls below it. Sort of like the mailing list itself:

However, when someone requests an author or other facet revert replies back to the expanded result (or at least the one first one).

This can be filtered using the type field (they are labeled either "original_post" or "reply").

When I press the return button after typing my query, It doesn't close the keypad. See the video below.
*Note: the zoom issue you see in the video has been fixed in this pr #102 *

Would like text from title and link to chaincode.com

When page changes, content still stays at bottom of the screen.

Segregate css files (modular) and switch to scss

Add a loading state while querying for results

Combine mailing list summaries are shown in the results but the url is to the original post. Link to tldr.

Remove the "1-20" on left and default pull-down for the number of results listed on right and default it to the maximum (why not?). Replace with the total number of results (will have to check if that raw number is delivered from the API).

Add tags to the pills at the bottom of each result.

Not sure on the colors here. Maybe it makes sense to differentiate.

A click on a pill should highlight that facet both in the sidebar and in the results. Clicking it again should remove the filter.

Implementation of the new UI design revamp for bitcoin search
Figma link here

also addresses #79