Hi@erlend-aasland, I know you are interested in AC. Could you take a look at the PR. Is it necessary to change the example used in the article. Thank you very much.

Hi,@littlebutt! I've already added Alex and myself as reviewers. I'll try to review it within this week. If not, feel free to ping me :)

Also, it isvery nice to see some interest in improving the clinic docs!

Hi,@littlebutt! I've already added Alex and myself as reviewers. I'll try to review it within this week. If not, feel free to ping me :)

Thank you!

Hi@erlend-aasland , I modify the origin function to fit all cases in the document. Is it okay with you? Also, I changed some examples beforethe converter step. Because readers will confuse when they meet converter ahead of its introduction.

cc.@serhiy-storchaka@ezio-melotti

@littlebutt, I worry that this change is premature; the clinic tutorial definitely needs an overhaul, but I think we need to do some basic adjustments before we get to the part where we tear out the existing example. I started doing some adjustments to the clinic docs in small steps (see#106876 and#106904).

Here's a very course plan:

1. get rid of the numbered list
2. in multiple steps, align the language of the tutorial with theDiátaxis recommendations -- hopefully, it will shrink in size :)
3. start reworking the example used in the tutorial (this PR!)

What do you think? :)

@littlebutt, I worry that this change is premature; the clinic tutorial definitely needs an overhaul, but I think we need to do some basic adjustments before we get to the part where we tear out the existing example. I started doing some adjustments to the clinic docs in small steps (see#106876 and#106904).

Here's a very course plan:

1. get rid of the numbered list

2. in multiple steps, align the language of the tutorial with theDiátaxis recommendations -- hopefully, it will shrink in size :)

3. start reworking the example used in the tutorial (this PR!)

What do you think? :)

It sounds like a good idea. The tutorial needs improvement and a single PR obviously cannot change a lot. More effort should be made to optimize the document.

The Argument Clinic docs have moved tohttps://github.com/python/devguide. Please open a new PR over there.