mojo icon indicating copy to clipboard operation
mojo copied to clipboard

[Docs]What should keywords `borrowed`, `inout`, and `owned` be called collectively

Open soraros opened this issue 1 year ago • 3 comments

Where is the problem?

N/A

What can we do better?

As title. It's a bit clunky to enumerate them every time in conversations. Maybe we could call them "argument something-something marker".

Anything else?

N/A

soraros avatar Feb 10 '24 04:02 soraros

Currently the docs call them "argument conventions": https://docs.modular.com/mojo/manual/values/ownership.html#argument-conventions

arthurevans avatar Feb 12 '24 22:02 arthurevans

@arthurevans Thanks for the pointer. So the keywords indicates the argument conventions used. My question was, what do we call the keywords themselves. Shall we call them "argument convention annotation/marker" (just choose one so people can use it).

soraros avatar Feb 13 '24 01:02 soraros

if this is specific to borrowed, inout, and owned, i think something more specific to ownership would help, maybe argument ownership markers? Realistically if this was added in docs, id want to see it under a page for argument conventions, then these could be in a subheading for ownership.

Benny-Nottonson avatar Feb 17 '24 00:02 Benny-Nottonson