1 files changed, 28 insertions, 0 deletions
diff --git a/examples/comments_example.md b/examples/comments_example.md
new file mode 100644
index 00000000..3aa2e877
--- /dev/null
+++ b/examples/comments_example.md
@@ -0,0 +1,28 @@
+## Description
+
+You could add comments (visible or hidden) to the cells.
+
+## Code
+
+```ruby
+require 'axlsx'
+
+p = Axlsx::Package.new
+wb = p.workbook
+
+wb.add_worksheet(name: 'Comments') do |sheet|
+  sheet.add_row ['Can we build it?']
+  sheet.add_comment ref: 'A1', author: 'Bob', text: 'Yes We Can!'
+  sheet.add_comment ref: 'A2', author: 'Bob', text: 'Yes We Can! - but I dont think  you need to know about it!', visible: false
+end
+
+p.serialize 'comments_example.xlsx'
+```
+
+## Output
+
+![Output](images/comments_example_1.png "Output")
+
+After hovering on the hidden comment:
+
+![Output](images/comments_example_2.png "Output")