~/talk

Documentation Nobody Reads and UX in the Internal Dev Kitchen

on YouTube 53m
TalkinRussianat Joker 2022 · 2022-11-08..11-19· [documentation, ux-and-product-design]

speaker

name:Ruslan Cheremin
links:none on file

resources

video:https://youtu.be/mdCLzc146To
slides:none on file

summary

Ruslan Cheremin explores how human cognitive limitations affect internal developer experience, arguing that code, tools and documentation should be designed for human brains rather than idealized machines. He links UX principles and human factors research (e.g., rule complexity, automation ironies) to practical developer problems like unreadable documentation and poor engineering communication, and cites specific writings such as The Pyramid Principle and several blog posts with recommendations and examples.

AI-written summary · about

chapters (14)

  1. 0:00Introduction
  2. 1:12Why documentation matters
  3. 5:12Lack of feedback problem
  4. 9:36Instructions in complex systems
  5. 16:35Automation and human factor
  6. 22:33Tools to simplify tasks
  7. 27:26Role of examples in learning
  8. 33:20Documentation as a tool
  9. 36:31Hierarchy and layers
  10. 41:53Addressing different audiences
  11. 45:07Documentation chaos
  12. 46:10Anti-examples and error consequences
  13. 50:28Reading recommendations
  14. 52:13Q&A

related talks

~/search
type to search 6,249 conferences, 138,987 speakers and 185,172 talks
~/help
cmdctrl k
search every conference, speaker and series
/
focus the filter search
h
home
c
conferences
s
speakers
e
series
t
light / dark — the status bar button does the same
?
this help
esc
close this, then clear every filter — or just the search, while you are typing in it

Ignored while you are typing. Pages without a filter rail have no search to focus.