The description includes description of previous commented values

[kaworu]

Might be related to #92

values.yaml

# -- before desc
before: ~

# -- commented desc
#commented: ~

# -- after desc
after: ~

expected output

Key	Type	Default	Description
after	string	nil	after desc
before	string	nil	before desc

actual output

Key	Type	Default	Description
after	string	nil	commented desc -- after desc
before	string	nil	before desc

[norwoodj]

This is unfortunately a consequence of how the go yaml library works. It treats everything from the first comment as the HeadComment of after. I'm sorry but there's not much I can do here, it's just a quirk of the go yaml library. I suggest you submit an issue against them to break comments on whitespace so the first comment block is parsed independently of the second one.

[bmcustodio]

I may be definitely missing something, but shouldn't adding something like this

lastIndex := 0
for i, v := range commentLines {
  if strings.HasPrefix(v, "# --") {
    lastIndex = i
  }
}
if lastIndex > 0 {
  return ParseComment(commentLines[lastIndex:])
}

to https://github.com/norwoodj/helm-docs/blob/master/pkg/helm/comment.go#L7 be safe and enough? I made a quick and dirty test and it seemed to work well:

| Key | Type | Default | Description |
|-----|------|---------|-------------|
| after | string | `nil` | after desc |
| before | string | `nil` | before desc |

Opened #99, please feel free to close it if I'm totally wrong here.