[Python] Clarify approach for namespacing

[kanterov]

Changes

Clarify the approach for namespacing in Python code.

Why

It's important to understand the motivation behind it.

[eng-dev-ecosystem-bot]

Run: 18904183055

	Env	❌​FAIL	🟨​KNOWN	🔄​flaky	💚​RECOVERED	🙈​SKIP	✅​pass	🙈​skip
🔄​	aws linux			4	1	2	319	585
💚​	aws windows				1	2	324	584
❌​	aws-ucws linux	6	1		1	1	437	481
❌​	aws-ucws windows	6	1		1	1	438	480
🔄​	azure linux			3		2	321	584
🔄​	azure windows			3		2	322	583
❌​	azure-ucws linux	6	2			1	435	480
❌​	azure-ucws windows	6	2			1	436	479
🔄​	gcp linux			6	1	2	316	586
🔄​	gcp windows			2		2	322	585

23 failing tests:

Test Name	aws linux	aws windows	aws-ucws linux	aws-ucws windows	azure linux	azure windows	azure-ucws linux	azure-ucws windows	gcp linux	gcp windows
TestAccept	💚​R	💚​R	🟨​K	🟨​K	🔄​f	🔄​f	🟨​K	🟨​K	💚​R	🔄​f
TestAccept/bundle/artifacts/artifact_path_with_volume/volume_doesnot_exist	🙈​s	🙈​s	❌​F	❌​F	🙈​s	🙈​s	❌​F	❌​F	🙈​s	🙈​s
TestAccept/bundle/artifacts/artifact_path_with_volume/volume_doesnot_exist/DATABRICKS_BUNDLE_ENGINE=direct-exp			❌​F	❌​F			❌​F	❌​F
TestAccept/bundle/artifacts/artifact_path_with_volume/volume_doesnot_exist/DATABRICKS_BUNDLE_ENGINE=terraform			❌​F	❌​F			❌​F	❌​F
TestAccept/bundle/artifacts/artifact_path_with_volume/volume_not_deployed	🙈​s	🙈​s	❌​F	❌​F	🙈​s	🙈​s	❌​F	❌​F	🙈​s	🙈​s
TestAccept/bundle/artifacts/artifact_path_with_volume/volume_not_deployed/DATABRICKS_BUNDLE_ENGINE=direct-exp			❌​F	❌​F			❌​F	❌​F
TestAccept/bundle/artifacts/artifact_path_with_volume/volume_not_deployed/DATABRICKS_BUNDLE_ENGINE=terraform			❌​F	❌​F			❌​F	❌​F
TestAccept/bundle/destroy/jobs-and-pipeline	🔄​f	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f	✅​p
TestAccept/bundle/destroy/jobs-and-pipeline/DATABRICKS_BUNDLE_ENGINE=direct-exp	🔄​f	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p
TestAccept/bundle/destroy/jobs-and-pipeline/DATABRICKS_BUNDLE_ENGINE=terraform	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f	✅​p
TestAccept/bundle/local_state_staleness	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f	✅​p
TestAccept/bundle/local_state_staleness/DATABRICKS_BUNDLE_ENGINE=terraform	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f	✅​p
TestAccept/bundle/resources/clusters/deploy/data_security_mode	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f	✅​p	✅​p	✅​p	✅​p
TestAccept/bundle/resources/clusters/deploy/data_security_mode/DATABRICKS_BUNDLE_ENGINE=direct-exp	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f	✅​p	✅​p	✅​p	✅​p
TestAccept/bundle/resources/pipelines/allow-duplicate-names	🔄​f	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p
TestAccept/bundle/resources/pipelines/allow-duplicate-names/DATABRICKS_BUNDLE_ENGINE=terraform	🔄​f	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p
TestAccept/bundle/resources/synced_database_tables/basic	🙈​S	🙈​S	💚​R	💚​R	🙈​S	🙈​S	🟨​K	🟨​K	🙈​S	🙈​S
TestAccept/bundle/run/app-with-job	🙈​S	🙈​S	🙈​S	🙈​S	🙈​S	🙈​S	🙈​S	🙈​S	🙈​S	🙈​S
TestAccept/bundle/templates/default-python/combinations/serverless	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f
TestAccept/bundle/templates/default-python/integration_classic	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f	✅​p
TestAccept/bundle/templates/default-python/integration_classic/DATABRICKS_BUNDLE_ENGINE=direct-exp/UV_PYTHON=3.10	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	✅​p	🔄​f	✅​p
TestAccept/selftest/record_cloud/pipeline-crud	✅​p	✅​p	✅​p	✅​p	🔄​f	✅​p	✅​p	✅​p	✅​p	✅​p
TestAccept/selftest/record_cloud/pipeline-crud/DATABRICKS_BUNDLE_ENGINE=direct-exp	✅​p	✅​p	✅​p	✅​p	🔄​f	✅​p	✅​p	✅​p	✅​p	✅​p

[github-actions]

This PR has not received an update in a while. If you want to keep this PR open, please leave a comment below or push a new commit and auto-close will be canceled.