Re: [Emacs-diffs] master 4d3a595: `load-path' should contain only directory names

[Eli Zaretskii]

> From: Stefan Monnier <address@hidden>
> Cc: address@hidden,  address@hidden,  address@hidden
> Date: Tue, 27 Oct 2015 15:00:55 -0400
> 
> >> > We just want to be consistent in the stuff we generate.
> >> I'm fine with this.  But I object to documenting too precisely the form
> >> that should be in load-path and then tell people that if they don't do
> >> that they live dangerously.
> > OK, I won't tell that.  (It was a joke, anyway.)
> 
> But even if we don't say it explicitly, the change in docstring hints at
> the fact that this detail matters, whereas it really shouldn't.

I see nothing wrong with recommending best practices in doc strings.
We do that all the time.