livebook icon indicating copy to clipboard operation
livebook copied to clipboard

Add cell comments

Open basilenouvellet opened this issue 2 years ago • 7 comments

Issue fix #261

Demo

https://user-images.githubusercontent.com/24209524/162003937-4b392926-7e7c-4cde-bba4-9a4a37b30c16.mp4

Left to do

  • [ ] Ability to edit & delete comments
  • [ ] Fix autofocus issue on the comment text input
  • [ ] Persist comments in *.livemd ~& *.exs~ files

basilenouvellet avatar Apr 06 '22 14:04 basilenouvellet

@josevalim @jonatanklosko even if the PR is still a draft, feel free to comment & provide feedback

basilenouvellet avatar Apr 06 '22 14:04 basilenouvellet

This is looking great @BasileNouvellet! Just one note: we don't need to have comments on the .exs file. Just .livemd ones.

@jonatanklosko do you think it is worth a sidebar item that lists all comments? Not as part of this PR, of course, but something to consider.

josevalim avatar Apr 07 '22 08:04 josevalim

do you think it is worth a sidebar item that lists all comments?

It depends on how prominent we make comments on cells. However, we could list all comments by timestamp, rather than grouped, this way it's easy to check if there's a new comment somewhere.

jonatanklosko avatar Apr 07 '22 10:04 jonatanklosko

In terms of UI mechanics, by default we shouldn't be showing much, my suggestion would be

  • when a cell has no comments, we show nothing, and when the cell is focused we show a comment icon, clicking on it opens the discussion
  • when a cell has comments, we show the comment icon and comment count next to it, clicking on it opens the discussion

jonatanklosko avatar Apr 11 '22 13:04 jonatanklosko

@BasileNouvellet thanks for the updates! I've just edited the comment above, don't worry about other UI details for now, we will reiterate on it once we have the full design :)

jonatanklosko avatar Apr 11 '22 14:04 jonatanklosko

Hey, just to let you know that I'm off currently, and that I will be able to resume work on this feature next week. In the meantime, did you get the chance to iterate on the final UI design?

basilenouvellet avatar Apr 29 '22 17:04 basilenouvellet

@basilenouvellet thanks for the update, just so you know there is no rush! We are still awaiting the design, as there were several other design-related things we prioritized :)

jonatanklosko avatar May 02 '22 09:05 jonatanklosko

Thank you so much for the work here @basilenouvellet, but unfortunately we are postponing this feature for now.

Livebook is moving to an architecture where developers run notebooks on their machine. So while we will definitely want comments in the future, comments are not helpful unless we have a central architecture where comments and collaboration happen on the fly, and that will likely come just later.

josevalim avatar Aug 23 '22 06:08 josevalim

I understand, thank you for the explanation @josevalim. Happy to work on it later when needed!

basilenouvellet avatar Aug 23 '22 11:08 basilenouvellet