Good design for developers & good design for non-developers don’t operate by different rules. Devs aren’t happy needing to memorize manuals, and end users can & will learn things if it makes their lives easier.