シェルスクリプトの関数コメントのスタイル、いい感じの模索してる

pizza_order.sh

#!/bin/sh

#
# Short description
#
# Long description (multiline)
# :pizza: :pizza: :pizza:
#
# Examples:
#
#   pizza_order "bacon" 3 && {
#     echo "Successful order. Thank you!!"
#   }
#
# Args:
#
#   $1 - Pizza name to order
#   $2 - Number to order
#
# Return:
#
#   Status of whether the order was successful
#
pizza_order() {
   # (order)
}