There is nothing inherently wrong with putting them into .zshrc!

The reasons I keep them separate is because:

a) I can simply backup the `custom` directory and restore onto a "vanilla" oh-my-zsh installation b) I can use descriptive file names which would otherwise have to be comments

Also, some software likes to append stuff (like adding directories to PATH) to .zshrc upon installation so it gets kind of messy over time.

I guess the comment is from the plain zsh installation and oh-my-zsh just didn't remove it.