Is it known, that several Deep-Links within the do...
# documentation
t
Is it known, that several Deep-Links within the documentation are broken? I'm talking about ones that jump to an anchor tag using a # in the url. Some seem to just have disappeared, some have weird reasons like https://docs.pact.io/implementation_guides/jvm/provider/gradle#publishing-pact-files-to-a-pact-broker which is used at https://docs.pact.io/getting_started/sharing_pacts#language-support . The heading the link refers to still exists, but it seems like it's no longer an anchor. From what I saw so far, it seems like the documentation is scattered across several repos, but maybe this can be detected automatically nevertheless?
y
Hmm, It isn’t registering as a heading in the nav bar as its set to a top level heading https://github.com/pact-foundation/pact-jvm/blame/master/provider/gradle/README.md#L818 the h2 headings above and below are rendered in the side bar on the right hand side. I think the resolution is to update to h2
##
the docs get synced from pact-jvm and other client libraries and is pulled into the docs site. if you amend it directly in the docs it will overwritten, but allows you to check it working on a PR as we get a netlify preview. Wasn’t aware of it, but something we can sort 🙂
we did have a setup for brokenLinks, along with an outstanding issue on docusaurus for detection during dev https://github.com/pact-foundation/docs.pact.io/pull/122#pullrequestreview-921519307