On 27/06/2025 04:57, Charles Choi wrote:
On Jun 26, 2025, at 5:16 AM, Max Nikulin wrote:
I think, we may save some time for new users by clearly saying that
specific instructions were applicable several years ago, but there is no
point to try them now even if org-protocol does not work.
The guidance org-protocol provided before the rewrite steered me down so
many dead ends. That frustration drives much of my motivation to rewrite
it. While I have tried to be mindful of previous contributors work on
this, I would rather not treat it as gospel.
Do not consider the following as pressure on you. I am trying to figure
out what style I should avoid if I decide to update e.g. Linux .desktop
example.
I suggest to clearly mark dead ends as so.
Brief clear instruction is nice when you are absolutely sure that no
user will face trouble.
Consider users that are not really new ones. They may be trying to setup
their new computers and they approximately remember steps that were
necessary several years ago. Completely new guide may be surprising. It
might be more comfortable for them to find familiar commands, but with
explanation why it is not an alternative any more.
