google thinks the docs are mobile unfriendly

[benjaminp]

BPO	23312
Nosy	@birkenfeld, @benjaminp, @ezio-melotti, @encukou, @karlcow, @berkerpeksag, @serhiy-storchaka, @JulienPalard

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2022-04-08.11:57:08.674>
created_at = <Date 2015-01-24.17:42:05.110>
labels = ['type-feature', '3.9', 'docs']
title = 'google thinks the docs are mobile unfriendly'
updated_at = <Date 2022-04-08.11:57:08.673>
user = 'https://github.com/benjaminp'

bugs.python.org fields:

activity = <Date 2022-04-08.11:57:08.673>
actor = 'petr.viktorin'
assignee = 'docs@python'
closed = True
closed_date = <Date 2022-04-08.11:57:08.674>
closer = 'petr.viktorin'
components = ['Documentation']
creation = <Date 2015-01-24.17:42:05.110>
creator = 'benjamin.peterson'
dependencies = []
files = []
hgrepos = []
issue_num = 23312
keywords = []
message_count = 9.0
messages = ['234625', '234634', '234659', '234665', '234666', '234667', '347304', '347305', '416980']
nosy_count = 10.0
nosy_names = ['georg.brandl', 'benjamin.peterson', 'ezio.melotti', 'ionelmc', 'petr.viktorin', 'karlcow', 'docs@python', 'berker.peksag', 'serhiy.storchaka', 'mdk']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue23312'
versions = ['Python 3.9']

[benjaminp]

According to Google webmaster tools, the documentation has the following failings on mobile devices:

• The font size is too small. https://developers.google.com/speed/docs/insights/UseLegibleFontSizes
• The viewport is not configured.
• Touch controls are too close together.

You can look at the complaints on (for example) https://developers.google.com/speed/pagespeed/insights/?url=https%3A%2F%2Fdocs.python.org%2F3%2Flibrary%2Ffunctions.html

[birkenfeld]

Yes, the theme is anything but "responsive". If someone already knows how to do this, please step forward.

I guess it's not too hard to move the sidebar to the top/bottom on mobile, and adapt the font sizes.

[birkenfeld]

There is already an enhanced theme: https://github.com/ionelmc/sphinx-py3doc-enhanced-theme

I will have a look at it.

[ionelmc]

You can see that theme in action at http://python-aspectlib.readthedocs.org/en/latest/

[birkenfeld]

Are you ok with us copying parts of the enhancements?

[ionelmc]

Sure, take anything you want.

[karlcow]

This issue should probably be addressed now on https://github.com/python/python-docs-theme

[karlcow]

I created python/python-docs-theme#30

[encukou]

This has been solved by the new theme. The Goolgle report linked above shows “Passed” and “96” (out of 100).
It does show a few opportunities to improve, but many seem to indirectly complain that the page is big.

I'm closing the issue.