Re: Opaque objects and Emacs documentation

[Eli Zaretskii]

> Cc: npostavs@gmail.com, emacs-devel@gnu.org
> From: Dmitry Gutov <dgutov@yandex.ru>
> Date: Tue, 21 Jul 2020 22:08:47 +0300
> 
> On 19.07.2020 17:48, Eli Zaretskii wrote:
> > Because having user commands
> > that allude to "project instance" without even a minimal explanation
> > of what that is makes our documentation of such commands almost
> > useless, and the question that bothers me is how to keep the quality
> > of our documentation at its usual high level while using these or
> > similar design and implementation patterns.
> 
> I started replying to say that you are welcome to propose improvements 
> for better description of allowed semantics, but then again, you 
> probably meant something like more details about which cons cell 
> contains which values.

Actually, no.  For user commands it is better to describe a project in
terms of outside world: files, directories, repositories, etc.

> In the meantime, I have added more text to Commentary in project.el. 
> Please take a look whenever convenient.

It is orders of magnitude better than what we had before.  Thank you
very much for working on that.