During POC, using wiki-in-iframe might be enough, yet wiki has number of usability issues for our case of “documentation on tips of your fingers”. Here are random notes on dedicated frontend:

HUD visualsation notes:

• Incoming contexts that have HUDI: Title is shown on bottom of HUD with Edit button.
  • Clicking “Edit” causes that HUDI to expand
    • keyboard focus is at that HUDI.
    • Button “Edit” is changed to “Close”
    • cursor location is at the same spot the user left it at last edit
  • Expanded HUDI shows as TextArea on top of the window, overlapping “Contexts/Titles” list underneath
  • If other Expanded HUDI exist, they are moved below and new HUDI is opened above.
  • Pressing ESC would cause the HUDI to disappear (and “Close” to become back “Edit”).
    • Expanded HUDI are moved back, with focus switching to previous HUDI.
  • If the user never opened the HUDI, then popup is pushed (once).
  • If someone edited the HUDI, then “Edit” becomes “Proofread”.
    • In Proofreading mode there is additional column on left that shows diff status. Changed lines have “zoom glass with red question mark inside” mark. As user moves cursor off the changed line, the question mark in zoom glass becomes green V sign, and disappears after a second. If there still are “unreviewed” changes above or below, then on top or bottom of the “diff status” column there appears arrow with smaller “zoom glass with ? mark”. Clicking on these would jump the text, so next changed line is in the middle of text area.
  • Other users, as they get into the context, will see that the HUDI was changed, with popup (once) and “Proofread” button
• Titles scroll from bottom to up
• If no HUDI exists for the contexts, show context name and “Create” button
• Expanding HUDI would open the HUDI several lines around the cursor position (stored per HUDI) in “Expanded” section
• Nice to have: enlarge any Expanded section (may be full screen button?)

blah