You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
How do the starlark docs represent optional parameters? Should we use an a question mark such as:
func(n?)
If so, should the page render this ? differently to make it stand out better? Perhaps a different font?
How do complex types get represented? For example "list of strings" or "tuple of two ints". One possibility is using list(string) and (int,int). Note that we can't use (int, int) because the outline parser sees the space and terminates the token.
How do we represent any types? What about type unions? For example, many DataFrame methods have parameters that are allowed to be a "list, or Series, or DataFrame, or iterable".
The answers to these types of questions should be standardized so that the docs are consistent.
The text was updated successfully, but these errors were encountered:
How do the starlark docs represent optional parameters? Should we use an a question mark such as:
If so, should the page render this
?
differently to make it stand out better? Perhaps a different font?How do complex types get represented? For example "list of strings" or "tuple of two ints". One possibility is using
list(string)
and(int,int)
. Note that we can't use(int, int)
because the outline parser sees the space and terminates the token.How do we represent
any
types? What about type unions? For example, many DataFrame methods have parameters that are allowed to be a "list, or Series, or DataFrame, or iterable".The answers to these types of questions should be standardized so that the docs are consistent.
The text was updated successfully, but these errors were encountered: