[UI] Docs explaining how to use the accordion component

[andersonjeccel]

This PR introduces documentation for the accordion component, addressing a critical gap in our UI toolkit. Without this, developers would struggle to implement accordions consistently, leading to inconsistent user experiences and increased development time.

Here I provide instructions on how to properly utilize the accordion component, including best practices.

[favour-chibueze]

@RCheesley Could you please help with this issue? I’ve fixed the Vale error, but it seems a link is breaking, which is causing the build to fail.

cc: @andersonjeccel

[RCheesley]

@favour-chibueze it looks like https://docs.mautic.org/en/5.x/configuration/cron_jobs.html#tracking-script is no longer a valid link. This is because it was (rightly) moved out of the Cron Jobs section: https://docs.mautic.org/en/5.x/configuration/tracking_script.html.

So we need a separate PR to fix that build failure in the link file. Can you do that?

[favour-chibueze]

@favour-chibueze it looks like https://docs.mautic.org/en/5.x/configuration/cron_jobs.html#tracking-script is no longer a valid link. This is because it was (rightly) moved out of the Cron Jobs section: https://docs.mautic.org/en/5.x/configuration/tracking_script.html.

So we need a separate PR to fix that build failure in the link file. Can you do that?

Here's the PR that fixes this

[RCheesley]

Great, good to go then if you're happy with the PR changes @favour-chibueze and they render well. I haven't checked it yet myself.

[RCheesley]

I have some concerns about two settings files which I think don't relate to this PR - can you take a look?

[andersonjeccel]

@RCheesley It seems RTC

[RCheesley]

Please fix the heading nesting:

H1 ###
H2 ***
H3 ===
H4 ---
H5 ~~~

[RCheesley]

The heading nesting is incorrect in this PR and it needs tweaking before it can be merged. Please see earlier comment.