tests(helpers): support ldoc generation

[chronolaw]

Summary

KAG-5333, support ldoc generation.

• edit config.ld, add directory ./details and merge=true
• add @module header for separated test modules

Checklist

• The Pull Request has tests
• A changelog file has been created under changelog/unreleased/kong or skip-changelog label added on PR if changelog is unnecessary. README.md
• There is a user-facing docs PR against https://github.com/Kong/docs.konghq.com - PUT DOCS PR HERE

Issue reference

Fix #[issue number]

[chronolaw]

@Tieske , could you take a look? thanks.

[Tieske]

added some minor fixes.

what strikes me is that the section "Custom assertions" contains a ton of unrelated stuff, eg. start_kong used to be located under "shell helpers"?

[Tieske]

fyi: the spec/renderdocs.sh scripts can be used to re-render docs on the fly while editing them.

[chronolaw]

added some minor fixes.

what strikes me is that the section "Custom assertions" contains a ton of unrelated stuff, eg. start_kong used to be located under "shell helpers"?

We could fix these concerns later, now we will focus on module splitting.

[team-gateway-bot]

Cherry-pick failed for master, because it was unable to cherry-pick the commit(s).

Please cherry-pick the changes locally.

git remote add upstream https://github.com/kong/kong-ee
git fetch upstream master
git worktree add -d .worktree/cherry-pick-13636-to-master-to-upstream upstream/master
cd .worktree/cherry-pick-13636-to-master-to-upstream
git checkout -b cherry-pick-13636-to-master-to-upstream
ancref=$(git merge-base 5ac6e1e541dd9d7219044f500b7954892c49dcf0 e4123dab32b50ae26f50a0f7ba9d3e2e6aef0143)
git cherry-pick -x $ancref..e4123dab32b50ae26f50a0f7ba9d3e2e6aef0143