php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Bug #66136 viewport widths less than 767px are problematic
Submitted: 2013-11-21 08:29 UTC Modified: 2015-01-03 10:59 UTC
From: aaron at aaronholmes dot net Assigned: levim (profile)
Status: Closed Package: Website problem
PHP Version: Irrelevant OS: N/A
Private report: No CVE-ID: None
 [2013-11-21 08:29 UTC] aaron at aaronholmes dot net
Description:
------------
---
From manual page: http://www.php.net/function.str-replace
---

I accessed the str_replace function documentation with my window set to 764px wide, and was presented with a list of other string functions instead of the content I was looking for. My immediate thought was that I typoed the function name, which I tried to correct. A couple page refreshes later, I realized I needed to scroll down to see the documentation.

It would be helpful if the page automatically scrolled down to the documentation, or presented the documentation before the function list.

Expected result:
----------------
I expected to see the documentation for the function str_replace.

Actual result:
--------------
I was presented with a list of other functions, and tried to get to the correct page, even though I was already on the correct page. I needed to scroll past the list of all the string functions to see the documentation for str_replace.

Patches

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2013-12-18 13:23 UTC] salathe@php.net
-Type: Feature/Change Request +Type: Bug -Package: Documentation problem +Package: Website problem -Assigned To: +Assigned To: levim
 [2013-12-18 20:04 UTC] levim@php.net
The original intent was to use a link to skip all navigation to get to content; would that suffice or do you really think switching the order would be better? I am not a mobile user and on a desktop using a window smaller that 768px seems absurd to me, so I am open to suggestions.
 [2013-12-19 10:15 UTC] aaron at aaronholmes dot net
The size of my browser window in this case is half the resolution of my macbook (I use hyperdock to automatically size windows, and I have browser windows side-by-side most of the time).

I think a link would get lost in the page content, and generally, the less clicks it takes to get to what a user is looking for, the better.
I don't believe switching the order is the best solution either.

What do you think of an "accordion-style" container for the list of functions, and leaving the "String Functions" header in place, with an icon (a down-pointing chevron?) to indicate that it's expandable?

Something like this: http://imgur.com/3Ix9DdD
 [2013-12-19 19:30 UTC] bjori@php.net
Looks good, do you have the patch?
 [2013-12-19 19:34 UTC] levim@php.net
I do not yet have a fix for this because of demands on my time; I am taking a long vacation soon and will be able to fix it then. If someone wants to go ahead and fix it before me, we have two options:

 1. Provide a "Skip to Content" link.
 2. Switch the order of the related functions list and the content so that content is displayed first.

I am still undecided which approach I like better but either one is better than what's live.
 [2013-12-19 19:35 UTC] levim@php.net
Oh, and Aaron's idea might work, which would be option 3.
 [2013-12-19 19:40 UTC] aaron at aaronholmes dot net
I do not have a patch, I threw together the change in Chrome's dev tools.

Where can I access the code for the site? I will make the change there and submit a patch.
 [2015-01-03 10:59 UTC] jacob@php.net
-Status: Assigned +Status: Closed
 [2015-01-03 10:59 UTC] jacob@php.net
This appears to have been fixed as the "mobile" and "tablet" views of the site are showing the documentation before the function listing. 

Please re-open should you still be seeing this issue.
 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Thu Mar 28 19:01:29 2024 UTC