BookStack icon indicating copy to clipboard operation
BookStack copied to clipboard

Feature Request: Pop up notes

Open ghost opened this issue 6 years ago • 5 comments

For Feature Requests

Desired Feature:
It would be nice to be able to insert a note in the documentation where it creates an indicator a note is available and hovering over the note displays additional information. Similar to a comment in Excel or Power Point.

ghost avatar Oct 27 '17 16:10 ghost

@dsaundersWizmo This is somewhat like what I had in mind in #428 maybe?

Though it might be beneficial if it has it's own issue (this one)?

Shackelford-Arden avatar Oct 27 '17 20:10 Shackelford-Arden

Hi @dsaundersWizmo, Thanks for the suggestion.

I think that linking the comment system into this to be able to link a comment/note to a particular block of content is a well suited request for BookStack.

It just becomes a little bit more challenging when deciding what to do upon changes. For example, What happens when the block of content is moved/updated/destroyed? What if the comment on the note is resolved? Who can mark it as resolved?

ssddanbrown avatar Nov 06 '17 21:11 ssddanbrown

Hi @ssddanbrown I am the guy implemented the 'Inline Comment' in Confluence, and would like to share some main ideas:

  • The note is also a comment, it just has another attribute to mark it as 'comment'
  • Who can comment on page, they can create note.
  • So it follows all the rules of comment on edit, update, delete, reply (if we want to reply a note)
  • Comment link to page, page deletion will delete all comments, include note.
  • The moving content will make note become dangling status
  • We need another screen to manage 'dangling', 'resolved' note (could be a popup)

tuedang avatar Nov 14 '17 16:11 tuedang

Hi Guys, As an interim solution, you can add HTML span tag to your documentation. While Editting, click on source code <> Say you want to add a pop up note to the text "apple"..

(replace the # with the less than sign '<' and the ## with the greater than sign '>')

Add #span title="A fleshy,usually rounded red, yellow, or green edible pome fruit"##
before the word, then add #/span## after the word.

Apparently it works everywhere including this comment. Which is why I couldn't paste the exact code, it just adds the mouse-over pop up. Hope this helps.

Implementing this through a single click could be a quick way to do it but can't say if its a good way as per best practices and compatibility.

Screenshot below: image

openmoto avatar May 15 '19 18:05 openmoto

+1

YuntiDevOps avatar Apr 17 '22 12:04 YuntiDevOps