Another advantage: Technical writers write from the perspective of users. Devs are sometimes too close to the code (too much scaffolding and presumptions) to un

Another advantage: Technical writers write from the perspective of users. Devs are sometimes too close to the code (too much scaffolding and presumptions) to understand what the user’s experience and thought processes are like. Technical writers can bridge that. Writing as a process also helps expose gaps in thinking — in this case, in the user facing implementation. This feedback can in turn be useful for devs. One example of where technical writing can help is PySpark. Because Spark is JVM centric, it can be relatively difficult for Pythonistas to get started with unless one already knew how things were laid out. I had to read multiple tutorials to set things up the right way before “import pyspark” would even work. Not to diminish the tremendous amount of efffort that has gone in the Spark docs, but that is one area where a good technical writer could add a lot of value. Side note: “findspark”, for the trivially simple package that it is, simplified getting up and running with PySpark. But I had to find out about it through a random tutorial.