Discussion:
[Design] [Wikitech-l] A new extension of content tree about Wikipedia
quiddity
2014-12-20 22:20:57 UTC
Permalink
(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)
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
* http://underscorejs.org/
* Wikipedia iOS App: Loading Image...
* 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.
Loading Image...
Loading Image...
Loading Image...
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
Federico Leva (Nemo)
2014-12-21 10:06:14 UTC
Permalink
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
quiddity
2015-01-04 23:42:47 UTC
Permalink
Post by quiddity
[...]
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.
* 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:
Loading Image...
Loading Image...
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.
Post by quiddity
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.
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.
http://cl.ly/Z7DO
http://cl.ly/Z7B4
This is great indeed!
Could this eventually be a new Beta Feature?
Krinkle
2015-01-05 18:22:58 UTC
Permalink
Post by quiddity
Post by quiddity
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.
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.
http://cl.ly/Z7DO
http://cl.ly/Z7B4
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
Prateek Saxena
2015-01-09 12:25:40 UTC
Permalink
@Prateek I've made a few improvements you may want to import.
Thanks Timo!
Done! https://github.com/prtksxna/persistent-toc/commit/fe0a0653b56e7a4e3c9f025c32359942e0f22f54

Moved the script to Github for easier patching.
https://github.com/prtksxna/persistent-toc#persistent-table-of-contents-for-wikipedia
Continue reading on narkive:
Loading...