9 ms·
This might even become standard for most documentations.
by agumonkey 7y ago
This might even become standard for most documentations.
- piotrkubisa 7y ago> This might even become standard for most documentations. I hope not, because slow, meaningless animation makes me tired and something inside me wants escape that page. Also it affects scrolling, especially noticeable when I am scanning a text instead of reading - you might lose context (note how the presentation reacts on pressing "page-up" / "page-down"). Kindle and all e-reader hates animations[0][1] - any animations (they are just huge black holes for battery). IMHO any documentation SHOULD be able to printed out on paper and sorry - paper is not interactive. However, I will warmly welcome some interaction in dedicated docs section but it would be great if it could be duplicated as a rich-text article. [0]: Not saying about the reader mode in browsers (e.g. Firefox) [1]: Please think also about people that are disabled or use VoiceOver/NarratorMode to be more productive / are just lazy to read text using their eyes :)
- agumonkey 7y agoNo worries, i understand, but I felt it told the code History in a valuable way. I usually stay away from shiny presentation.
- regular_person 7y agoI found it very slick and cool-looking but not really conducive to absorbing information.
- spectramax 7y agoI couldn't disagree more. This is not what a documentation should be like. Unnecessary animations, fixed scrolling, and just useless "snazzy" aspects of user interface has no place in code documentation. I hope this does not become the standard.
- ckrailo 7y agoIt's a good thing the post is a teaching tool and not documentation!
- fishnchips 7y agoI don't think it would work well for documentation where you may only look for a very specific piece of information and maybe a little bit context. This style of presentation would, in my opinion, work best for tutorials where every new concept builds on top of previous ones, and context is king.