commitlint icon indicating copy to clipboard operation
commitlint copied to clipboard

Docs: parserOpts and headerPattern need detailed docs

Open vitonsky opened this issue 3 years ago • 9 comments

We use modified version of conventional commits standard on the project and we start use commitlint.

Today i've found problem with config of commitlint and tried to found any info about how to fix it, i've read docs site https://commitlint.js.org and i totally can't found nothing useful information. This site just list availavle option names and examples, but not explain meaning of each option.

It seems that we need to configure parserOpts object and set headerPattern regular expression to parse our commit message, but commitlint just not provide explaining what is this, how it works and how we can use it for our purposes.

We have to improve docs and add descriptions about this, otherwise this powerful tool just useless for developers, because instead of safe our time, it's just take away our time to explore source code of this tool. Right now this tool looks not reliable.

Could you please tell us how many time you need to improve docs?

vitonsky avatar Aug 24 '22 16:08 vitonsky

If you have time to dig into this and provide a PR that would be great.
Maybe have a look into other issues related to parserOpts and headerPattern and see if you find info there. See i.e. #607

escapedcat avatar Aug 25 '22 01:08 escapedcat

This guide is a great starting point for documentation: https://strdr4605.com/commitlint-custom-commit-message-with-emojis

samayer12 avatar Oct 27 '22 22:10 samayer12

@samayer12 thank you, but we decide to stop use tool that no have docs.

It sad that users a forced to write guides how to use tool to solve basic problems. If you know another tools like this, but with not so bad documentation, share with me please

vitonsky avatar Oct 28 '22 10:10 vitonsky

@samayer12 thank you, but we decide to stop using tools that do not have docs.

It is sad that users a forced to write guides on how to use tools to solve basic problems. If you know another tool like this, but with not-so-bad documentation, share them with me, please.

I'm looking for an alternative too.

SalahAdDin avatar Oct 28 '22 10:10 SalahAdDin

@samayer12 thank you, but we decide to stop use tool that no have docs.

It sad that users a forced to write guides how to use tool to solve basic problems. If you know another tools like this, but with not so bad documentation, share with me please

Almost one year since this issue was opened and still no documentation for parserOptions? Thought this package would help me with managing my commits, but an uncomplete documentation doesn't helps as I'd like to configure my own options...

synulux avatar Aug 07 '23 05:08 synulux

Soon 2 years...

SpinBoxx avatar Jun 11 '24 13:06 SpinBoxx

@SpinBoxx "help wanted" tag is still valid ;)

escapedcat avatar Jun 12 '24 11:06 escapedcat