docs: clarify fish_greeting function and variable in FAQ

Tidy fish_greeting section in main documentation.

Closes #1506.