Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Search UX improvements #3051

Closed
pankajparashar opened this issue Feb 9, 2024 · 5 comments · Fixed by #3097
Closed

Search UX improvements #3051

pankajparashar opened this issue Feb 9, 2024 · 5 comments · Fixed by #3097
Labels
cat: general General content.

Comments

@pankajparashar
Copy link
Contributor

Link to the documentation page:
https://learn.microsoft.com/en-us/search/

Description of the issue:
The Search experience on the Docs site is a bit meh. For example,

  1. There is no option to narrow the search scope within Microsoft Edge DevTools. The closest option is Microsoft Edge which yields more results, so have to manually look at the URL path to find out which one belongs to DevTools.
  2. Clicking on the links on the search result, takes you to the start of the page, and not the section which has the text that was shown in the search result. So again, have to manually jump to that section using Find in Page.
    image
  3. Eventually I did find what I was looking for on Page 5 of the search results (this link). It could have been a bit faster if there was an option to do pt1. Since all I could remember was the term "screenshot" but didn't remember what that option in the context menu was actually called.
  4. Links belonging to DevTools docs have an odd title, "Microsoft Edge Development" instead of more familiarly named "Microsoft Edge DevTools". This could make easier to filter results that belong to DevTools instead of visually parsing the URL path below the title.
    image
@captainbrosset
Copy link
Contributor

captainbrosset commented Feb 13, 2024

Thanks for filing this Pankaj. Let me bring this back to the team for discussions.
For info, though, note that our documentation website on learn.microsoft.com is not just for DevTools. Our table of content shows that we document DevTools, PWAs, platform, webview2, extensions, test automation, and more. Basically everything that has to do with Edge for web developers.
This explains some of the confusion you've experienced.

@captainbrosset
Copy link
Contributor

For information, we've not forgotten about this issue @pankajparashar. Michael has already made a change to the suffix displayed on the results page. It's now Microsoft Edge Developer documentation.
We can't make it more specific than this, and only about DevTools, because, as said previously, our docset contains documentation for DevTools, PWAs, platform, WebView2, extensions, test automation, etc.
But hopefully this change is already a little improvement.

I've started thinking about your first point too, and I'm experimenting with restricting search results to just our docset, instead of the entire Edge docs. Although this won't restrict them to just DevTools, it should be much better than today.

@pankajparashar
Copy link
Contributor Author

Great work! guys. I can already feel a remarkable difference in the Search UX. Sorry for a bit of rant in the opening remark, I certainly appreciate the work done, understand the constraints and am very positive that this is headed in the right direction.

image

@captainbrosset
Copy link
Contributor

#3051 should be the final step needed to close this issue. It won't solve your feedback about search results containing more than just devtools, but we can't solve this feedback without splitting the devtools docs into their own docset, which we're not planning on doing at this point.

@mikehoffms
Copy link
Contributor

mikehoffms commented Mar 11, 2024

#3051 should be the final step needed to close this issue. It won't solve your feedback about search results containing more than just devtools, but we can't solve this feedback without splitting the devtools docs into their own docset, which we're not planning on doing at this point.

probably meant PR #3097 should be the final step to close this issue (Issue #3051)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
cat: general General content.
Projects
None yet
3 participants