There's an old idea, one which never took hold in any serious way, called "literate programming," that nonetheless has been discussed at some length over the years. The idea is that code should be more prose than code, and that reading a codebase should feel like reading a piece of literature. Now that the industry is more mature, the general consenus is that this is not a realistic way to write software.