I see self-documenting code as another type of comment, not a replacement. The comments describe what the code is supposed to be doing, what business problem it addresses, etc, while the code documents how the code does what it does. Your comments shouldn't get out of date unless the purpose of the code changes. If it's just the implementation that changes, the comments should still apply.