How to upload docs?

I am going to upload (I mean PR) my docs to dfinity/portal as a submodule.

The problem is that my repo contains Motoko sources, rather than docs, and docs are auto-generated.

Should I create a separate repository (probably added as a submodule to my main repo) to contain docs? Or should I remove instruction not to distribute docs from my .gitignore and link directly to my main repo as a dfinity/portal submodule?

I realize that both variants have (dis)advantages. But maybe, it helps, if you tell, what is the accepted practice.

The portal repo does not accept submodules or dedicated documentation pages that are for packages or libraries not maintained by DFINITY. If you’d like to have your product’s docs featured on the Dev Docs, we’d be happy to link (where appropriate) to your product’s documentation hosted on its own domain.