[coldtea]

>The docs don't seem to disagree with me.

You said "You plug the Pencil into the iPad to pair it. It comes with an adapter that you use to charge it with a regular cable."

As a response to the parent, your comment makes sense only if you meant to imply: "you're not supposed to plug it to charge it, only to pair it".

But if you meant to imply that as the right way to do things as according to Apple, you're wrong.

Apple suggests to plug it to the iPad to charge it (not just to pair it), and mentions the charge cable only as something you can "also" do.

In other words, Apple doesn't say you're just meant to "plug the Pencil into the iPad" only to pair it, and not only it doesn't discourage users to charge by plugging to the iPad, it suggests it.

[artimaeis]

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?

[coldtea]

>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".

[artimaeis]

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.

[1] https://www.youtube.com/watch?v=uE9hHO4hM0c