3 ms·
Yes, this is a common dilemma. Some suggestions on how to handle in docs: * Too much information is usually better than too little. You can organize the extra
by kaycebasques 8y ago
Yes, this is a common dilemma. Some suggestions on how to handle in docs:
* Too much information is usually better than too little. You can organize the extra information into separate sections, which makes it easier for the advanced audience to skip over.
* Prioritize one audience over the other.
In the case of presentations I'd probably stick to prioritizing one audience over another. Given a room of people, who is it most important to transfer knowledge to? Better to make half the room happy, than none of the room.
- ghaff 8y agoIt's easier in documentation/writing because people can skim or just quickly decide that what's there isn't for them. There's more of a commitment in a presentation. It helps to advertise things accurately. Although there's no shortage of people who come to an "Introduction to" talk and expect it to be deep in the weeds.
- kaycebasques 8y agoAgreed, presentations are harder than writing in this respect. Conversely, I think docs are usually more effective than video when it comes technical communication precisely because you can scan them. Generally speaking, it’s just a more flexible mode of communication. Although I’ll add that I do supplement the DevTools tutorials with video versions, because some people prefer to see GUI workflows in action.