René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Usage of leading underscores","articleBody":"Normal Python usage, of course, uses leading underscores to indicate that a name is intended to be private. My understanding is that this library deviates from this convention by instead using leading underscores to limit what is included in the Sphinx-generated documentation. Names with leading underscores defined at module level are often used in other modules, and names with leading underscores defined at class level are often used outside the class, and even from other modules. In effect, such names are treated as private to the _package_. Is this understanding correct?\n\nI would suggest looking into controlling visibility in the Sphinx-generated documentation separately and gradually migrating to normal Python usage.\n","author":{"url":"https://github.com/rimey","@type":"Person","name":"rimey"},"datePublished":"2016-04-22T14:04:21.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":8},"url":"https://github.com/1735/google-cloud-python/issues/1735"}