Skip to content

Can't search docs.flutter.io from a mobile browser #2071

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

Closed
zoechi opened this issue Dec 17, 2018 · 11 comments
Closed

Can't search docs.flutter.io from a mobile browser #2071

zoechi opened this issue Dec 17, 2018 · 11 comments
Labels
p3-low Valid but not urgent concern. Resolve when possible. Encourage upvote to surface. t.mobile Relates to the mobile friendliness of an app

Comments

@zoechi
Copy link

zoechi commented Dec 17, 2018

@eseidelGoogle commented on Mon Jul 30 2018

At least in Chrome on iOS (and presumably other mobile browsers) there is no search box on docs.flutter.io.

@mjohnsullivan @jcollins-g


@jcollins-g commented on Mon Jul 30 2018

dart-lang/dartdoc#1348


@zoechi commented on Thu Dec 06 2018

Same problem in https://flutter.io and https://docs.flutter.io

@zoechi
Copy link
Author

zoechi commented Dec 17, 2018

On my Pixel XL I see the search icon
only in landscape mode or when I switch to desktop site.

image

@chalin
Copy link
Contributor

chalin commented Dec 17, 2018

At least in Chrome on iOS (and presumably other mobile browsers) there is no search box on docs.flutter.io.

There is if you browse in landscape view. Is that good enough for now @eseidelGoogle @mattrenquist et all?


Same problem in https://flutter.io

For flutter.io, the search box is under the hamburger:

screen shot 2018-12-17 at 10 42 44

cc @kwalrath @sfshaza2

@chalin chalin added info needed t.mobile Relates to the mobile friendliness of an app labels Dec 17, 2018
@zoechi
Copy link
Author

zoechi commented Dec 17, 2018

Discoverability is not great though.

@chalin
Copy link
Contributor

chalin commented Dec 17, 2018

@InMatrix @galeyang - thoughts?

@galeyang
Copy link
Contributor

I agree that the discoverability is not great. If we would like to move it to the header, we need to rearrange the existing header items due to the limited space. For example, other frameworks created a minimized version of logo (e.g. Angular and React use an icon-only version, Firebase uses a text-only version) or hide those icons for social media (i.e. Twitter and Youtube icons).

For the usage, in the past month, only a few unique searches were from mobile devices. I guess it's partly because of the low discoverability and the fact that most programming activities are on desktop. Therefore, if we have future plans on improving general search features on the website (e.g. auto-suggestion, search results), I'm also fine with making changes later and working on high priority issues first.

@chalin chalin added P4 and removed info needed labels Dec 18, 2018
@kwalrath kwalrath added p3-low Valid but not urgent concern. Resolve when possible. Encourage upvote to surface. and removed P4 labels Dec 28, 2018
@sfshaza2
Copy link
Contributor

  • Do you mean that you can't search docs.flutter.io from flutter.io?
  • The search text field is under the hamburger menu on flutter.io. Is this acceptable?

I guess I'd like to close this bug, unless we deem that the search needs to be directly on the mobile front page.

@eseidelGoogle @galeyang

@eseidelGoogle
Copy link
Contributor

I'm not sure how I search on docs.flutter.io:

image

@eseidelGoogle
Copy link
Contributor

I suspect this is a dartdoc bug more than a flutter/website bug?

@sfshaza2
Copy link
Contributor

There is a search textfield on docs.flutter.io. It is suboptimal in my opinion, though. It seems to be on every page, so that's a good thing. But it forces code completion and it doesn't even look at the docs for Java and ObjectiveC. Those packages are almost undiscoverable.

screen shot 2019-01-29 at 2 46 41 pm

Finally, bugs against the docs should be filed against the flutter/flutter repo (if content based) or the dartdoc repo (if tool based), rather than the website repo.

@sfshaza2
Copy link
Contributor

Oops, oops, oops! You are completely right that it's impossible to search the Flutter API docs from a mobile device. But this bug should be filed against dartdoc. I will open a bug there, and close this one.

@sfshaza2
Copy link
Contributor

Opened a bug against dartdoc:
dart-lang/dartdoc#1914

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
p3-low Valid but not urgent concern. Resolve when possible. Encourage upvote to surface. t.mobile Relates to the mobile friendliness of an app
Projects
None yet
Development

No branches or pull requests

6 participants