Re: [ELPA] New package: transient

[Stefan Monnier]

FWIW, I completely agree with this.
Emacs's own "core" library should follow the "prefix" convention.
The resulting "structuring" of the names would help discoverability

This was a major motivation for the `seq` and `map` packages, and maybe
we should keep doing that with more things (e.g. add a `list` package
where all the list functions get a new name using the `list` prefix, or
add a `process` package were all the process related primitives are
given a "process-"prefix, ...).


        Stefan


Philippe Vaucher [2020-04-29 11:50:08] wrote:

>>
>> > Overall I think it's a shame that the Emacs api wasn't designed with
>> discoverability/consistency in mind
>>
>> Would you mind elaborate on this deficiency?  I don't think I quite
>> understand the complaint.
>
>
> It's hard to really criticize because Emacs was designed ages ago.
>
> My point is simply this one: when I look at
> https://github.com/magnars/dash.el, https://github.com/NicolasPetton/seq.el
>  or https://github.com/magnars/s.el I can immediately understand how the
> library works and how to achieve things. I can also easily use `C-h f` to
> find about the function I want.
>
> In Emacs, parts of it are designed following the same principle, but a lot
> of it isn't:
>
>    -
>    
> https://www.gnu.org/software/emacs/manual/html_node/elisp/Association-Lists.html
> sometimes
>    assoc, alist-get, assq, copy-alist. How am I supposed to use `C-h f alist
>    TAB` to discover the function I want? I can't, I have to go to that webpage
>    and read it all.
>    -
>    
> https://www.gnu.org/software/emacs/manual/html_node/elisp/List-Elements.html
> sometimes
>    named logically (nth, remove, append), sometimes named after implementation
>    detail (car, cdr), and no grouping at all so I can't `C-h f list TAB`
>
> Kind regards,
> Philippe