Section link:

Suggestion:
Add link for:
[create_client]: https://github.com/Azure/azure-sdk-for-python/blob/master/sdk/containerregistry/azure-containerregistry/samples/sample_create_client.py
[create_client_async]:
https://github.com/Azure/azure-sdk-for-python/blob/master/sdk/containerregistry/azure-containerregistry/samples/async_samples/sample_create_client_async.py

Section link:

Suggestion1:
Add import asyncio

Suggestion2:
Update to:
async def create_registry_client(self):

Suggestion3:
Update to:
async def create_repository_client(self):

Suggestion4:
Update to:

async def main():
    sample = CreateClients()
    await sample.create_registry_client()
    await sample.create_repository_client()
    await sample.basic_sample()
if __name__ == "__main__":
    loop = asyncio.get_event_loop()
    loop.run_until_complete(main())

Section link:

Suggestion:
Add link for [API reference documentation] :
https://azuresdkdocs.blob.core.windows.net/$web/python/azure-containerregistry/1.0.0b1/index.html

@jongio for notification.