bisq-network / proposals

@bisq-network improvement proposals
https://bisq.wiki/Proposals
44 stars 16 forks source link

Bisq Dictionary #392

Closed UX-P closed 1 year ago

UX-P commented 1 year ago

Hi everyone,

From past research it has been reported that the Bisq website and specific points are a little too technical for the onboarding trader. I agree certain terms employed on the app are not very user friendly and some text require simplifying, however, there are terms used throughout the cryptocurrency industry the new trader would benefit from learning. I had previously suggested a ‘Word of the Day’ to be posted on Bisq’s social media to help in gaining a familiarity with industry words or phrases, however, in noticing the scarcity of general onboarding tools, a dictionary may be a more impactful contribution.

Product

The Bisq Dictionary (the name is not official) is aimed at the beginner and mid trader and provides definitions to terms and phrases used by Bisq, other trading platforms and the general cryptocurrency industry.

Words should only be described in correlation to the cryptocurrency industry with Bitcoin as the main focus, here are a few examples of key words and it’s user market:

Generally new to the industry Bitcoin Peer-to-Peer Decentralization

Beginner Trader Arbitrator Node Escrow BSQ

Mid Trader CLI API Tor Seed Nodes

How it works (these screenshots are a prototype, please treat all wording as placeholders and not official copy) :

  1. The landing page displays the word of the week, this would ideally be a term relevant for that week.
wordoftheday
  1. The user searches for a word and is provided with the definition.
Bitcoin
  1. When the user clicks the cat logo on the bottom right, the card expands revealing a breakdown of how the term is applicable to Bisq.
bitcoinextend
  1. 'Keywords will be highlighted within the text and redirect the user to its definition when clicked.
hyperlink

Marketing

Here are a few ways this could be used as a marketing tool:

Impact Expectations

Responsibilities (including post-delivery)

Compensation of $40/hr

Research on latest news and updates to keep up to date with trending terms Engaging with the community to monitor pain points in regards to wording Engage with contributors for proofreading Researching and using keywords for effective google SEO Updating the site with new words and phrases Researching and writing word definitions General website maintenance Provide summary of work with screenshots

Deliverable

Compensation: $3510

This is a long term deliverable and its utility is vast with an impact transferred throughout the Bisq user market. The website will already provide 20 words and definitions at the time of delivery but will continue to be updated. I would like to keep the project small in terms of development leaving room for iteration. A static site or an edge function will be provided and completed within 3 weeks. Ideally the website would be under the Bisq subdomain e.g. dictionary.bisq.network

Please let me know what you think and if you have any questions! Thanks

ghost commented 1 year ago

Sounds expensive, and would need maintenance.

https://bisq.wiki already fulfills the role. Years of effort have gone into explaining the technicalities of Bisq, like Arbitrator, Mediator, the DAO, trading and dispute processes.

There's a myriad of educational information, youtube presentations etc on how Bisq works and how to use it.

If anything, missing keywords like API, CLI can be added to the bisq wiki.

Also, search engines do a better job of finding information: ![image](https://user-images.githubusercontent.com/47253594/200334539-06047272-4388-4472-bfd9-a95bf708b6ea.png)
HenrikJannsen commented 1 year ago

Thanks @UX-P for the interesting proposal!

I agree that for not-expert users Bisq is a bit challenging and the available information at webpage/wiki/docs/youtube is quite scattered and a lot to read. To get that better organized would be good IMO and your suggestion could be a tool for non-expert traders to get an easier entry to Bisq.

w0000000t commented 1 year ago

I agree with @jmacxx that it would overlap with the wiki, and detract from the extensive and long-running job it's been done on it. In my experience, people are just lazy most of the time, and I don't see users actively browsing such a knowledge base, at least not more than what they would with the existing wiki. Also, users like human interaction, and as a support agent I can confidently say that they are much happier if another human will point them to the wiki (or youtube, oor any other platform) link, rather than go and fetch the information autonomously (which, as shown by @jmacxx, can be easily done on any search engine already)

UX-P commented 1 year ago

hi @w0000000t @jmacxx thanks for the feedback concerning the wiki, I will hopefully be able to explain how they differentiate.

We all appreciate the work that has been put into the wiki and it acts as an effective guide providing information and instructions on how Bisq works. The support channel demonstrates that it is referred to often when an issue has occurred and so does not have the same functionality as the dictionary but could certainly be used in conjunction and I agree that it is essential for the wiki to continue in being maintained.

Bisq dictionary would be specifically aimed at helping potential traders and current traders with technical terms used across the BTC industry. The descriptions are brief, concise and to the point, easy for an onboarder to understand the most complex words, within a paragraph. Yes search engines are good for finding information, with effective SEO the average user typing ‘What is peer 2 peer’ (in which there have been 480 searches on the 7th November from the US alone) will ideally land on the 'P2P' definition of the Bisq dictionary, generating footfall and an increase in engagement. With the Bisq credentials included on the site, we should also expect to see an increase in conversion thus acting as an effective promotional tool.

I have been informed from a technical standpoint that this is quite a low maintenance site but if you would like to advise on any technicalities I am missing please do so. From my part it will consist mainly of content management and research.

Furthermore, this proposal goes beyond technical definitions in the hope to also attract the attention of a wider community. There’s a lot of information and misinformation being spread currently online, and it would be a great opportunity to continue in contributing something informative to the community and those looking to join during this time.

UX-P commented 1 year ago

Here are examples of some search results.

api peer to peer cli

This data demonstrates the average number of monthly searches for a given keyword over a 12-month period, the number of potential users who could browse the 'Bisq Dictionary' knowledge base.

With effective SEO, the ‘Bisq Dictionary’ will rank in the top 10 search results to attract this user market. Consequently, Bisq should eventually see an increase in conversion, which is the overall aim.

The tool could also be used as an opportunity to increase the wiki’s visibility:

wiki
UX-P commented 1 year ago

@jmacxx I have just seen your drop-down image (hidden on my screen) and realised that there must have been a misunderstanding.

The product is primarily a general dictionary by Bisq and not literally a ‘Bisq Dictionary’, I can see where the tentative title may cause confusion. If discovered through the search bar, it would essentially be aimed at those who do not particular know or use Bisq, and are conducting more of a general search. The potential trader would not type ‘What is the Bisq DAO´ but more of 'What is a DAO’, to then land on the 'Technical Dictionary by Bisq' providing them with a general overview of what a DAO is. Only when the user clicks the icon on the bottom right, will they see a breakdown on how the DAO is applicable to Bisq.

Does this help to clarify the product a bit more?

pazza83 commented 1 year ago

The potential trader would not type ‘What is the Bisq DAO´ but more of 'What is a DAO’, to then land on the 'Technical Dictionary by Bisq' providing them with a general overview of what a DAO is. Only when the user clicks the icon on the bottom right, will they see a breakdown on how the DAO is applicable to Bisq.

I am not sure how valuable that would be. People searching for 'What is a DAO’ are likely not potential users of Bisq. Also there will be lots of competition for more generic search terms like this that a static Dictionary site would not be able to effectively compete for.

Why keep it simple and add a dictionary / glossary to the Bisq wiki?

Or maybe a word of the day pop-up etc for new users of the Bisq 2 app?

UX-P commented 1 year ago

Hi @pazza83, thanks! Those are good suggestions, my concern would be that they may not provide the experience described.

People searching for 'What is a DAO’ are likely not potential users of Bisq.

Amongst those users looking up DAO, there could be some interested in trading on Bisq, but that is not something I have researched into so I can not say at the moment.

there will be lots of competition for more generic search terms like this that a static Dictionary site would not be able to effectively compete for.

I agree that certain words would be more competitive than others however, there will be a variety of terms available along with a heavy reliance on the niche words and abbreviations (e.g. DEX) to help in ranking higher in search results.

In terms of instant measurable value, the tool will be available on Bisq where onboarding traders would open the dictionary if necessary, search a technical word, and read a quick overview of it’s description. The idea is to provide a pleasant, non-disruptive learning experience as they navigate through their trading journey. If the user requires a more intricate breakdown, the definitions will be linked to the corresponding wiki help pages.

In respect to adding a dictionary to the wiki, I don’t think it will provide the user with the same experience. Minimal navigation and a simplistic overview, with the choice of further exploration. Also, I have not considered the work a dictionary wiki would involve for Bisq developers in terms of updating, SEO management or any required access.

I plan to ensure this is kept as a very low maintenance product. As stated above, I can have this developed and delivered as a static site or edge function. I will however, need some assistance from developers and other contributors with writing and proofreading to ensure the descriptions are accurate and up to Bisq standards.

pazza83 commented 1 year ago

Closing due to lack of activity and no clear consensus.