norwoodj / helm-docs

A tool for automatically generating markdown documentation for helm charts
GNU General Public License v3.0
1.35k stars 184 forks source link

v1.10 ignores double "##" #148

Open mkilchhofer opened 2 years ago

mkilchhofer commented 2 years ago

Hi @norwoodj

It seems that v1.10.0 introduces a kind of different behavior. In the past we used something like this:

  # -- Define user-defined context
  ## For more information: https://argocd-notifications.readthedocs.io/en/stable/templates/#defining-user-defined-context
  context: {}
    # region: east
    # environmentName: staging

the new version now introduces this change:

-| notifications.context | object | `{}` | Define user-defined context |
+| notifications.context | object | `{}` | Define user-defined context # For more information: https://argocd-notifications.readthedocs.io/en/stable/templates/#defining-user-defined-context |

So in the past lines with two ## were ignored in the rendered README. Is this an intended change?

mszostok commented 2 years ago

The option to ignore the comments is quite useful. Our use-case is to have more info about the format:

  # Using existing Communication secret. It MUST be in the `botkube` Namespace.
  ## Secret format:
  ##  stringData:
  ##    comm_config.yaml: |
  ##      communications:
  ##        # Here specify settings for each app, like Slack, Mattermost etc.
  ##        # NOTE: Use setting format visible below.
  existingSecretName: ""

I hope that it will be added back 🤞

acolombier commented 2 months ago

Any update on this? Are you accepting PR to restore that behaviour?

norwoodj commented 2 months ago

Hey, indeed, Sorry about breaking this behavior, I see the utility of this feature. I would certainly accept a PR to change this back to the old behavior. I just don't have time to do it myself.