Re: [RFC] Document DirHandle as obsolete?

On 09/07/2016 10:22 PM, Aristotle Pagaltzis wrote:
> As per attached patch. This one goes back a long time.

1. You're giving an example saying to read the docs.
2. You're giving the explanation, then an alternative synopsis.

I would rather have the alternative synopsis first with a line of
comment above, such as "# This is the recommended way now". Then
underneath have the explanation, and then the old synopsis.

Otherwise, +1.

• [RFC] Document DirHandle as obsolete? by Aristotle Pagaltzis
• Re: [RFC] Document DirHandle as obsolete? by Sawyer X