(I've CC'd the design-list, for all of these ideas. Design: please see the earlier part of this thread (7 msgs) for more context, at https://lists.wikimedia.org/pipermail/wikitech-l/2014-December/079793.html)
On Fri, Dec 19, 2014 at 8:15 PM, Krinkle krinklemail@gmail.com wrote:
I'm not sure we should implement collapsible sections for desktop.
If built and instrumented, one may find that users use it a fair bit and it may be better-than-nothing as solution for certain use cases. But I don't think collapsible sections would be an adequate feature for those use cases.
Our table of contents is in desperate need of improvement. Having that be more accessible throughout the reading experience would be a big step forward[1] (much like the Wikipedia iOS app). Having a proper TOC means users don't have to collapse/expand anything.
This would allow users to have a birds eye view of the document at all times, jump to any section at any time, whilst still being able to scroll through the document top to bottom as one would expect.
From a performance viewpoint (as opposed to usability) we can still do optimisations such as not loading images until a section is accessed (lazy-load).
-- Krinkle
[1] Different ideas around an "aside"-accessible table of contents:
- http://underscorejs.org/
- Wikipedia iOS App: http://i.imgur.com/Sg0pqsg.jpg
- User manual: http://asciidoctor.org/docs/user-manual/
Re: Collapsible - I strongly agree that collapsing content is potentially harmful, and should be avoided as much as possible. It increases the effort required to see content, and thereby reduces the likelihood of any given section being seen. This is bad for readers (harder to access knowledge), and bad for editors/potential-editors (harder to spot errors/vandalism during casual reading). It goes for article content as well as navigational elements and metadata. Footer-navboxes are frequently collapsed, and I think this has established a harmful precedent. (See also [[Linus's Law]], "given enough eyeballs, all bugs are shallow". We need more eyeballs, not less.)
Re: ToC improvements - Agreed. As always, the difficulty is with fitting it in somewhere, given the diversity of screen/browser-window sizes that each user has or prefers. It would be especially useful on long articles, but it would also take up the most space there. I'm not sure where the most recent brainstorming and notes are, regarding the standard mediawiki sidebar? I know it's been discussed a *lot* over the years...
Re: "birds eye view" - I really like this idea, taken to the 'completism' level... A number of text/code editors, have a "minimap" attached to the side. http://did2memo.net/wp-content/uploads/2013/01/minimap-in-sublime-text-2.png http://i.imgur.com/OIhkpfA.png http://notepad-plus-plus.org/assets/images/docMap.png It works as an enhanced-scrollbar, and as an overview, and it shows text-selections from ctrl-F.
I think something similar to this would potentially help us: * To better understand the scope of an article/section/entry, upon first loading the page. * As editors, to find & refine wall-of-text paragraphs. * Encourage light-readers to scroll more, particularly if they see thumbnails of images - in the same way that good textbooks can use images as content-hooks. * more?
It would need Increased font size for headings, to enable ToC-like functionality. And some sort of minimal-version, for users who find animated-aspects too distracting. What else?
It might be too complicated to be a global default (UX-wise, and/or Performance-wise), but I'd love to see something like this as an option (toggle or preference or gadget).
HTH. --Quiddity
Having a proper TOC means users don't have to collapse/expand anything.
+1, TOC forever. The most underappreciated feature of MediaWiki!
Speaking of which, I'll add it to https://en.wikipedia.org/wiki/Comparison_of_wiki_software if missing.
Nemo
On Sat, Dec 20, 2014 at 2:20 PM, quiddity pandiculation@gmail.com wrote:
[...] Re: "birds eye view" - I really like this idea, taken to the 'completism' level... A number of text/code editors, have a "minimap" attached to the side.
http://did2memo.net/wp-content/uploads/2013/01/minimap-in-sublime-text-2.png http://i.imgur.com/OIhkpfA.png http://notepad-plus-plus.org/assets/images/docMap.png It works as an enhanced-scrollbar, and as an overview, and it shows text-selections from ctrl-F.
I think something similar to this would potentially help us:
- To better understand the scope of an article/section/entry, upon first
loading the page.
- As editors, to find & refine wall-of-text paragraphs.
- Encourage light-readers to scroll more, particularly if they see
thumbnails of images - in the same way that good textbooks can use images as content-hooks.
- more?
It would need Increased font size for headings, to enable ToC-like functionality. And some sort of minimal-version, for users who find animated-aspects too distracting. What else?
It might be too complicated to be a global default (UX-wise, and/or Performance-wise), but I'd love to see something like this as an option (toggle or preference or gadget).
Matma Rex made a proof-of-concept for this article-minimap idea. Code: https://meta.wikimedia.org/wiki/User:Matma_Rex/article-map.js Screenshots: https://commons.wikimedia.org/wiki/File:Minimap_script_screenshot_1.png https://commons.wikimedia.org/wiki/File:Minimap_script_screenshot_2.png By default, it just shows a button in the top corner, labeled "Render minimap". The rendered minimap is clickable, hence functions as a giant scrollbar.
It doesn't work as a ToC-replacement (for which Prateek's experiment is a much better contender), but it is a very interesting script, that I'll certainly leave enabled for the forseeable future.
On Mon, Dec 29, 2014 at 3:42 AM, Prateek Saxena psaxena@wikimedia.org wrote:
On Sat, Dec 20, 2014 at 9:45 AM, Krinkle krinklemail@gmail.com wrote:
Our table of contents is in desperate need of improvement. Having that
be more accessible throughout the reading experience would be a big step forward[1] (much like the Wikipedia iOS app). Having a proper TOC means users don't have to collapse/expand anything.
A buggy experiment:
importStylesheet( 'User:Prtksxna/toc.css' ); importScript( 'User:Prtksxna/toc.js' );Tested on latest Firefox and Chrome. Refreshing a couple of times usually takes care of any visual bugs.
This is great indeed! Could this eventually be a new Beta Feature?
On Sun, Jan 4, 2015 at 11:42 PM, quiddity pandiculation@gmail.com wrote:
On Mon, Dec 29, 2014 at 3:42 AM, Prateek Saxena psaxena@wikimedia.org wrote:
On Sat, Dec 20, 2014 at 9:45 AM, Krinkle krinklemail@gmail.com wrote:
Our table of contents is in desperate need of improvement. Having that
be more accessible throughout the reading experience would be a big step forward[1] (much like the Wikipedia iOS app). Having a proper TOC means users don't have to collapse/expand anything.
A buggy experiment:
importStylesheet( 'User:Prtksxna/toc.css' ); importScript( 'User:Prtksxna/toc.js' );Tested on latest Firefox and Chrome. Refreshing a couple of times usually takes care of any visual bugs.
This is great indeed! Could this eventually be a new Beta Feature?
Requesting it to be promoted to a gadget on en.wikipedia.org would be a good first step to wider visibility (nearly the same as a beta feature in terms of script abilities and user method for enabling). Community scripts FTW :)
@Prateek I've made a few improvements you may want to import:
https://en.wikipedia.org/wiki/User:Krinkle/toc.js?action=history https://en.wikipedia.org/wiki/User:Krinkle/toc.css?action=history
-- Krinkle
On Mon, Jan 5, 2015 at 11:52 PM, Krinkle krinklemail@gmail.com wrote:
@Prateek I've made a few improvements you may want to import.
Thanks Timo! Done! https://github.com/prtksxna/persistent-toc/commit/fe0a0653b56e7a4e3c9f025c32...
Moved the script to Github for easier patching. https://github.com/prtksxna/persistent-toc#persistent-table-of-contents-for-...