Hi Allen Li, thanks for reporting this. I think both behavior are good defaults, I tried to enhance the documentation a little bit.
If you see another way to enhance the documentation or the message sent by org-mode, can you suggest it? Thanks! -- Bastien