Docstrings

[christiangnrd]

Add docstrings for all missing docstrings from the Metal module except for MtlDeviceVector and MtlDeviceMatrix as I am unfamiliar with them. Also adds docstrings for the storage mode structs from MTL as those will potentially be used.

I added very basic docstrings for the MTL and MPS modules, but I feel like not having them gives a more useful output (exported names and such).

See #358

[maleadt]

This is great, thanks!

Some bike shedding below:

[christiangnrd]

@maleadt I've addressed the comments.

Also, do you have any thoughts on whether the MTL and MPS docstrings should stay?

[maleadt]

Also, do you have any thoughts on whether the MTL and MPS docstrings should stay?

Maybe a link to the Apple documentation, e.g., https://developer.apple.com/documentation/metalperformanceshaders? I considered suggesting an explanation on the different levels of wrappers (integrations, high-level wrappers, low-level wrappers), but that distinction isn't as clear in Metal.jl as it is in CUDA.jl where the low-level wrappers are auto-generated. Also, MTL doesn't really integrate with many interfaces. So it's probably not that valuable.

[christiangnrd]

I pushed some improvements based on your suggestions to the MTL and MPS docstrings. This PR is ready for final review.

[maleadt]

LGTM; couple of minor nits, let's merge this after.

[christiangnrd]

Done! I'll merge once tests pass or failures unrelated.

[maleadt]

Done! I'll merge once tests pass or failures unrelated.

Oh sorry, didn't see your message. Well, we don't have doctests anyway, so this shouldn't matter hopefully 😅