createPeriodicWave() ? a lot of missing contexts

[XR-XharpRazor]

documentation link :
https://developer.mozilla.org/en-US/docs/Web/API/BaseAudioContext/createPeriodicWave

---

My problem with the document

P1

in Parameters,
we see "cosine terms" and "sine terms"
in this case, it is better to give us the concept first, then the technical API stuff.
I would suggest putting the "(i.e. (a+bi)e^(i), (c+di)e^(2i), (f+gi)e^(3i) etc.)" part at the front first

P2

in the example, both arrays are only 2 elements long, for documentation purposes and explanations, please make an example like 4 or 6 elements long and then explain what does that mean.

P3

the oscillator node only gives one output, which is 1 number,
But how does a 2D output give you a 1D output ?

---

I hope the document can explain these

Here's an example of what I hope the document has :
assume that the PeriodicWave has

createPeriodicWave
(
   [c0, c1, c2, c3, c4, c5] ,
   [s0, s1, s2, s3, s4, s5]
)

Q1

what is the function of the generated wave ?
According to Fourier Series, a single vector needs a magnitude, a frequency, and a phase, here we only have "real" and "image"
I mainly understand Fourier Series by watching 3Blue1Brown

Q2

assume that now we accept the fact that using createPeriodicWave() gives you a wave in 2 dimensions, "real" and "image" (like the complex plane),
in audio editing / edm composing sense,
what does "real" and "image" mean ?

• does it refers to the "left" and "right" channel ?
• or it somehow convert this 2d behavior into some 1D output ?

---

I am looking forward to seeing what the devs or the enlightened ones can provide.
and hoping this discussion can make the documentation better
XR