Thanks for helping me with the links @melissawm! As for the broadcasting section- I was wondering if we could remove most of it from here since the information already exists in the Broadcasting doc. We could add a line about Broadcastable arrays in the Broadcasting doc itself and shift the section link there. I am not sure if I should do it in this PR itself or make a separate one.

I think I understand your goal with reorganizing the order of the sections but can you explain?

The flow I thought about-

• A brief introduction about ufuncs
• How to use these ufuncs? - their methods and arguments
• What will be the result after using these methods? - output type determination
• How do ufuncs work? - broadcasting, type casting, internal buffers
• Additional information for writing my own ufuncs - error handling
• Additional information about ufuncs that doesn't require modifying the ufuncs themselves- overriding ufunc behavior

Yes about broadcasting - I'd keep the first part:

Each universal function takes array inputs and produces array outputs
by performing the core function element-wise on the inputs (where an
element is generally a scalar, but can be a vector or higher-order
sub-array for generalized ufuncs). Standard
broadcasting rules are applied so that inputs not sharing exactly the
same shapes can still be usefully operated on.

but maybe link to the main broadcasting doc for the rest (making sure no information is lost in the process)

As for the organization that makes total sense, thanks!

I moved the Broadcastable arrays section to the Broadcasting doc. The "rules" that were written in that section are already explained in the doc so I decided to remove them. Also, let me know if this branch needs a rebase because I had to merge my broadcasting branch into this one and it adds an extra merge commit 🙂

You probably do need a rebase - but otherwise this looks good! Thanks for the great work here, @Mukulikaa !

I'll approve but wait for @rossbar to take a look :)