feat: add a new action to validate contribution to the bonita documentation content

[benjaminParisel]

Create action to validate the contribution follow our documentation guidelines.

• Adding forbidden pattern check (ex: static link to https://www.documentation.bontiasoft.com)
• Validate if some attributes are put in updated file (ex: :description: tag to help us for the SEO)

A test PR is opened in bonita-labs-doc to play with this new action

This PR is the first iteration of action to check contribution.

[tbouffard]

I have just tested the action with bonitasoft/bonita-labs-doc#148. Everything run fine 💪🏿

• detect errors in navbar/taxonomy files
• The PR comment is removed when there is no more errors
• several errors in the same file. One checkbox by file, all errors are displayed on the same line
• errors detected in Antora "partials"

[tbouffard]

❓ This new action seems to be usable only in the context of Antora and AsciiDoc. So, I suggest we find a better name.
Here are some proposals (none of these proposals satisfied me 😸 but they are better than pr-files-checker IMHO):

• pr-antora-content-checker
• pr-antora-diff-checker
• ....

[tbouffard]

Here are some suggestions to improve the wording.
I will check the action in the bonita-labs-doc repository soon.

[tbouffard]

❌ There is an error when running the actoin commit 0bacfa1 (https://github.com/bonitasoft/bonita-labs-doc/actions/runs/6561671422/job/17821868367?pr=148) or 62dad28 (https://github.com/bonitasoft/bonita-labs-doc/actions/runs/6571494407/job/17850750270?pr=148)

Download action repository 'bonitasoft/actions@ci/check-pr-guidelines' (SHA:0bacfa174c99d1a453fa1cc85d6df56e10977e2d)
Error: bonitasoft/actions/ci/check-pr-guidelines/packages/pr-antora-content-guidelines-checker/action.yml: (Line: 1, Col: 46, Idx: 45) - (Line: 1, Col: 81, Idx: 80): While parsing a block mapping, did not find expected key.
Error: System.ArgumentException: Unexpected type '' encountered while reading 'action manifest root'. The type 'MappingToken' was expected.
   at GitHub.DistributedTask.ObjectTemplating.Tokens.TemplateTokenExtensions.AssertMapping(TemplateToken value, String objectDescription)
   at GitHub.Runner.Worker.ActionManifestManager.Load(IExecutionContext executionContext, String manifestFile)
Error: Fail to load bonitasoft/actions/ci/check-pr-guidelines/packages/pr-antora-content-guidelines-checker/action.yml

[benjaminParisel]

❌ There is an error when running the actoin commit 0bacfa1 (https://github.com/bonitasoft/bonita-labs-doc/actions/runs/6561671422/job/17821868367?pr=148) or 62dad28 (https://github.com/bonitasoft/bonita-labs-doc/actions/runs/6571494407/job/17850750270?pr=148)

Download action repository 'bonitasoft/actions@ci/check-pr-guidelines' (SHA:0bacfa174c99d1a453fa1cc85d6df56e10977e2d)
Error: bonitasoft/actions/ci/check-pr-guidelines/packages/pr-antora-content-guidelines-checker/action.yml: (Line: 1, Col: 46, Idx: 45) - (Line: 1, Col: 81, Idx: 80): While parsing a block mapping, did not find expected key.
Error: System.ArgumentException: Unexpected type '' encountered while reading 'action manifest root'. The type 'MappingToken' was expected.
   at GitHub.DistributedTask.ObjectTemplating.Tokens.TemplateTokenExtensions.AssertMapping(TemplateToken value, String objectDescription)
   at GitHub.Runner.Worker.ActionManifestManager.Load(IExecutionContext executionContext, String manifestFile)
Error: Fail to load bonitasoft/actions/ci/check-pr-guidelines/packages/pr-antora-content-guidelines-checker/action.yml

Fixed ! It's a bad copy/paste :(

[tbouffard]

LGTM, good job, this was a tough one!