News for hackers. Stuff that matters.
Re:Build Your Own React by agumonkey on Thursday November 14, 2019 @02:10PM (#21538345)
This might even become standard for most documentations.
Re:Build Your Own React by piotrkubisa on Thursday November 14, 2019 @03:12PM (#21538925)
> 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 :)

Re:Build Your Own React by agumonkey on Thursday November 14, 2019 @04:48PM (#21539840)
No worries, i understand, but I felt it told the code History in a valuable way. I usually stay away from shiny presentation.
Re:Build Your Own React by regular_person on Thursday November 14, 2019 @04:21PM (#21539575)
I found it very slick and cool-looking but not really conducive to absorbing information.
Re:Build Your Own React by spectramax on Thursday November 14, 2019 @09:53PM (#21541850)
I 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.

Re:Build Your Own React by ckrailo on Sunday November 17, 2019 @02:45PM (#21559632)
It's a good thing the post is a teaching tool and not documentation!
Re:Build Your Own React by fishnchips on Friday November 15, 2019 @04:13AM (#21543449)
I 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.