docs: guidelines for public interface management by aucampia · Pull Request #2108 · RDFLib/rdflib (original) (raw)

A colleague of mine (@nikitabarskov) pointed out to me today that google does do what I'm suggesting here [ref], so there is some precedent for this approach. Google has for example google.cloud.bigquery and google.cloud.bigquery_v2 - the one difference is that they use bigquery_v2 instead of bigquery.v2, which is what my guideline amounts to.

I would have gone for rdflib_v7 though, but for the issues it causes with sphinx, as sphinx does not like having multiple top level modules the way we use it. I will have another look at sphinx to see if I can't maybe make it work like that, another option is to use rdflib.rdflib_v7, but I'm not sure that is better than rdflib.v7.