crystal docs sections

docs-section.cr

# Foo class for foo.
#
# # Bar methods
# Bar methods to bary things.
#
# * bar
# * bar?
#
# # Baz methods
# Baz methods to bazy things.
class Foo
  # @section Bar methods
  def bar; end

  # @section Bar methods
  def bar?; end

  # @section Bar methods
  def bar!; end

  # @section Baz methods
  def baz; end

  def qux; end
end

### Rendered Structure ###
### Tagged methods can be explicitly referenced in the section prose for order,
### but don't need to be.

# Foo class for foo.
#
# # Bar methods
# Bar methods to bary things.
#
# * def bar
# * def bar?
# * def bar!
#
# # Baz methods
# Baz methods to bazy things.
# 
# * def baz
#
# # Other methods
# 
# * def qux