chore: Move guides to the templates

[vipinvkmenon]

Purpose

• Movig guides to the docs section ensures that it come as a part of the terraform registry
• Refer: https://github.com/hashicorp/terraform-plugin-docs?tab=readme-ov-file#conventional-paths

Does this introduce a breaking change?

[ ] Yes
[x] No

Pull Request Type

What kind of change does this Pull Request introduce?

[ ] Bugfix
[ ] Feature
[ ] Refactoring (no functional changes, no api changes)
[x] Documentation content changes
[ ] Other... Please describe:

How to Test

• Test the code via automated test

n/a

• Additional test steps

n/a

What to Check

Verify that the following are valid:

n/a

Other Information

Checklist for reviewer

The following organizational tasks must be completed before merging this PR:

• The PR is assigned to the Terraform project and status is set (typically "in review").
• The PR has the matching labels assigned to it.
• The PR has a milestone assigned to it.
• If the PR closes an issue, the issue is referenced.
• Possible follow-up items are created and linked.

[lechnerc77]

I think this setup resembles a legacy setup. We kept the guides separate by intention to be able to make changes without pushing new releases of the provider.

Referencing the guides from the main page of the registry pointing to this repository

[lechnerc77]

This needs to be excluded from the lychee setup

[vipinvkmenon]

I think we can keep it in that approach itself then. As long as we have a pointer to the guides from the main page that'll do. I can close this PR then.

[lechnerc77]

As everything is available at https://registry.terraform.io/providers/SAP/btp/latest/docs I will close the PR as proposed.