Skip to content
This repository has been archived by the owner on Nov 17, 2023. It is now read-only.

[Website] Global Search Feature #18234

Closed
ys2843 opened this issue May 4, 2020 · 3 comments
Closed

[Website] Global Search Feature #18234

ys2843 opened this issue May 4, 2020 · 3 comments
Labels

Comments

@ys2843
Copy link
Contributor

ys2843 commented May 4, 2020

Description

MXNet website hosts not only rich and comprehensive documentations, but also many useful resources including tutorials, installation guide, APIs and blogs etc. The majority of our target users are those who are curious about MXNet and want to explore, their primary target will mostly be tutorials, FAQs, blog posts and other solution contents. But the current version of MXNet website does not provide anything for them to find the materials they need. This could prevent users from further exploring and staying interested in MXNet. And for power users who will come to API docs directly, it will greatly improve their experience if a global search feature is available everywhere not only within API document.

Proposed Solution

Global search feature on MXNet website can improve user experience, website usability and better convey our product values to end users. A search bar should be implemented on the top Nav bar accessible to users across all main information pages, with the capability of searching information across all site and always provide the valid and fresh results.
Integrate a stable and trust worthy 3rd party search service to MXNet websiteIt is a lot more cost and time efficient than start from scratch. DocSearch by Algolia is one of the site search solutions that is technical documentation oriented and widely adopted by many professional documentation websites including PyTorch, TypeScript, React, Bootstrap, Scala and GitLab etc.

Deliverable

A search bar powered by DocSearch on MXNet website, capable of searching across all site in any version, located on the right side of main Nav bar with a drop down menu attached that contains all available version options.

Acceptance Criteria

  • Search bar accessible across all information web pages
  • Providing real time searching, search as you type, always return fresh and valid result
  • The scope of search should be the whole website and all versions
  • Simple and consistent front end user interface for searching and result displaying

Stakeholders

@sandeep-krishnamurthy
@aaronmarkham
@leezu
@sojiadeshina
@szha

Reference

  1. Detailed quip project proposal - internal
  2. DocSearch website
  3. Please share your feedback here

Dev link

Demo link of this project: http://ec2-34-219-134-42.us-west-2.compute.amazonaws.com/

@ys2843
Copy link
Contributor Author

ys2843 commented May 5, 2020

@mxnet-label-bot add [website]

@ChaiBapchya
Copy link
Contributor

Thanks a lot for this feature.

Few suggestions

  1. Let's get rid of the symbol at the end of each line

Screen Shot 2020-05-09 at 2 13 40 AM

  1. Also it only gives 5 suggestions. Is there any way of giving more suggestions & preferably a longer list [scrollable?]

@ys2843
Copy link
Contributor Author

ys2843 commented May 11, 2020

@ChaiBapchya Thank you for the feedback. Very good suggestion. I will add it to the quip doc.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Projects
None yet
Development

No branches or pull requests

4 participants