minor formatting thing with these function definitions, but I think it's implied that any function can return null, it would make the docs more clear if we just omitted the `|null` part but kept the docs that describe the conditions in which the function can return null.