Reformat publisher documentation

[zbynek]

• Make sure you are opening from a topic/feature/bugfix branch (right side) and not your main branch!
• Ensure that the pull request title represents the desired changelog entry
• Please describe what you did
• Link to relevant issues in GitHub or Jira
• [n/a] Link to relevant pull requests, esp. upstream and downstream changes
• [n/a] Ensure you have provided tests - that demonstrates feature works or fixes the issue

The goal is to avoid horizontal scrolling for better display in GitHub and plugin site (jenkins-infra/plugin-site#750)

This PR splits the big table with horizontal scrolling into a table and a definition list.

[zbynek]

@aheritier will you have time to check this?

[aheritier]

I am back @zbynek
I will do it soon
Thanks a lot for this contribution, I agree with your fix. It's not readable today and we have to simplify this table like you did

[aheritier]

thanks a lot @zbynek

sorry again for the delay