complex-numbers concept docs

[colinleach]

New concept documents, for discussion.

You may want to cut the last bit of about.md. It got a bit preachy.

[colinleach]

Should I have added a comment that only documentation changed? I don't want Exercism to re-run every submitted Python exercise!

[colinleach]

Looking again at your Mermaid chart, I see that cmath has its own topic. My instinct is that this is a bit thin to break out by itself, but I'll be interested in your thoughts after reading this PR.

[BethanyG]

New concept documents, for discussion.
You may want to cut the last bit of about.md. It got a bit preachy.

Ha! I often "preach", so might not notice. 😉 I am just now getting to things, so I will make sure to take a look and comment.

Looking again at your Mermaid chart, I see that cmath has its own topic. My instinct is that this is a bit thin to break out by itself, but I'll be interested in your thoughts after reading this PR.

Ha, yes! I completely agree. Brain fart on my part, since clearly the concept for complex numbers should include the mathematical operations that can be performed. Let's combine the two into this concept/exercise. I'll loop back and prettify the chart .... er .... later. 😉 (The thing is a tad involved to edit).

Should I have added a comment that only documentation changed? I don't want Exercism to re-run every submitted Python exercise!

You shouldn't have to do that for documentation, since its not considered "significant" for the re-queueing of solutions for test. And overall, you'll not be needing it for new exercises in general, because they won't have any existing solutions to test or re-test. Finally, I will add it in if needed during review. I got your back! 😄

[colinleach]

I got your back!

Fortunate! I'll try not to call in this offer too frequently, but....

[BethanyG]

Nice work, you! I think this is a good start for the most part, but it might need a bit of re-arranging to present the practical parts of things in order.

I like all the references to application, but feel like a student would be searching for a few practical examples, but I am not clear yet on what they'd be that wouldn't have terrifying maths. My first impulse is an image translation, but .... not sure. Or maybe a simple circuit? Or a fractal? humm. I am going to let it sit a bit and then return tomorrow for another pass.

I am going to leave the introduction.md alone for now -- it needs to be shorter, but I can't think my way to it at the moment. Maybe after we both do a second pass.

[BethanyG]

Nice work on re-writing! 🚀

I am highly tempted to say we are done with this until we can figure out some longer examples and the pending questions about the complex plane, the unit circle, and ... what the heck we think we're going to cook up as an exercise.

I am almost to "let's merge this down, and come back later" - my only worry is that if we do that, it will show on the site (albeit not very discoverable) - so there might be critique from anyone who reads it. Then again, it would tell us if we've hit or missed the mark. What are your thoughts?

If you agree, I can put together an intro.md, and then we can both re-read the docs and merge.

[BethanyG]

Me either. All of the examples I've found have shown the unit circle and how things translate (rotate) when put on the complex plane. this rundown from Real Python uses a (contrived) example of the Bermuda Triangle. Very tempted to adapt it with a different region of the globe. Or maybe we use a simple geometric form and how it can be flipped and rotated easier on the complex plane. URG. More thought needed on my part, clearly.

[colinleach]

I'm supportive of an optimistic merge, with the option to circle back later for more revisions. Launching an exercise would have all sorts of downstream implications that are hard to reverse, but a concept seems relatively low-impact.

[BethanyG]

I'm too full of Pineapple fried rice right now to concentrate, but I'll put together and intro.md for review tomorrow, and then we can merge. 😄

[BethanyG]

So I think what you were seeing on your commit history with the title of introduction.md is not present here.

So I am going to merge this and the Fractions one in about 5 min. 😄 LMK if you have any further corrections or objections!

[colinleach]

Great, press the button!

[BethanyG]

MERGED 🎆