Registry documentation vs contributor documentation

I’m in the process of migrating from hand rolled Registry documentation to using terraform-plugin-docs however I’ve noticed that all the current implementations of terraform-plugin-docs expect the Registry documentation to live in the docs directory however we already have some user contributed documentation in there. Could someone shed some light on the following to help us make a decision on which way to go with this?

  • How are others approaching this conflict?
  • Is there a specific convention that is needed here for the Terraform Registry sync process to pick up the new documentation? I.e. it can exist in docs, website, etc but one takes priority.