Say you are tasked with writing something that can be done 2 different ways. Both have the same end-result.
In one way there's a single step.
In the other way, there's 2 steps and it involves another piece of equipment.
How might you write the documentation on how to do that thing?
Personally, I'd go with two sentences. The first that describes how to do the thing in one step. The latter, how to also do it in two steps and with another piece of equipment. I'm genuinely curious, is there a better way to approach that?
>Say you are tasked with writing something that can be done 2 different ways. Both have the same end-result.
That's my whole argument. That Apple presents it as 2 different equally good ways to achieve the same end result (and even mentions the pencil-protruding-dangerously way first and the second way as an aside).
In case you've lost context, I made the point to answer the parent commenter, who said that "the pencil-protruding-dangerously" is not a problem, because you're meant to charge the Pencil the cable-extension way in the first place (and sticking it directly to the iPad is just needed once at first to "pair it").
Well, my point is, if that's "how you're meant" to do it, (a) nobody told Apple, (b) Apple themselves suggested this fact to no one, and in fact went on to recommend the "just stick it" way as (a) equally good as the other, (b) first.
>Personally, I'd go with two sentences.
This is only OK if you assume both ways are equally safe and good. Which is my whole point: that Apple assumes that, and presents them as such -- when in fact they are not.
As for how I'd do it: "You can charge your Pencil with the provided cable adapter. In an immediate need, you can also just stick it on your iPad, but be careful, it's a brain damaged way, and it's easy to snap the egde that way".
Ah, I see how I misunderstood the point you were making in context. I read the word "can" in the point where it's not there.
I still don't agree that it's a particularly dangerous method of charging the device [1]. But I get that you'd change the wording since you feel it's dangerous.
In one way there's a single step.
In the other way, there's 2 steps and it involves another piece of equipment.
How might you write the documentation on how to do that thing?
Personally, I'd go with two sentences. The first that describes how to do the thing in one step. The latter, how to also do it in two steps and with another piece of equipment. I'm genuinely curious, is there a better way to approach that?