Setting up date / date pattern manually

[backdround]

I've noticed that there is an almost empty commit after any changes that aren't related to documentation:

this commit

It bothers me a little (I don't like to produce empty commits), and I see possible solutions:

• allow a user to set a date manually
• allow a user to set a date-pattern manually

Hypothetical github-actions' usage with the date:

      - name: Generate date
        id: generate_date
        run: echo "date=$(date +%Y)" >> "$GITHUB_OUTPUT"

      - name: panvimdoc
        uses: kdheepak/panvimdoc@main
        with:
          vimdoc: improved-search.nvim
          date: ${{ steps.generate_date.outputs.date }}

Hypothetical github-actions' usage with the date-pattern:

      - name: panvimdoc
        uses: kdheepak/panvimdoc@main
        with:
          vimdoc: improved-search.nvim
          date-pattern: "%Y"

I think date-pattern seems easier to use.

I would make a PR if you say it makes sense to implement any of the things.

By the way, thank you for the great project!

[kdheepak]

Thanks for opening an issue!

The lua output writer script actually already supports taking date as a metadata.

panvimdoc/scripts/panvimdoc.lua

Line 199 in 7e9a072

DATE = doc.meta.date

I just haven't propagated this option to the GitHub action or the panvimdoc.sh command line script. So this issue is good to track that feature.

Additionally, if we exposed the date pattern as well, here's where that pattern would go:

panvimdoc/scripts/panvimdoc.lua

Line 119 in 7e9a072

date = os.date("%Y %B %d")

There is also already currently a description: field that you can use that will replace both "For NVIM version" and "Last change: date" with a text description of your choice for reproducible docs (this is what I use for running tests on CI and locally). If this field is empty (which it is by default) it then uses the "For NVIM version" + "Last change: date" string as the description. I think I should better communicate this in the README.

[backdround]

@kdheepak
Sorry, I didn't understand what to do.

I don't think that date is very useful, but --title-date-pattern is
Is it okey if I delete meta.date and add meta.titledatepattern?