Mailing-List: contact zsh-workers-help@zsh.org; run by ezmlm
Precedence: bulk
Received-SPF: none (ns1.primenet.com.au: domain at brasslantern.com does not designate permitted sender hosts)
From: Bart Schaefer <schaefer@brasslantern.com>
Message-Id: <160722112126.ZM15554@torch.brasslantern.com>
Date: Fri, 22 Jul 2016 11:21:26 -0700
In-Reply-To: <20160722062259.GB3457@tarsus.local2>
Comments: In reply to Daniel Shahaf <d.s@daniel.shahaf.name>
        "Re: [PATCH v2] Re: [PATCH] _add-zle-hook-widget: New completion." (Jul 22,  6:22am)
References: <160716185103.ZM5258@torch.brasslantern.com> 
	<1468767614-9635-1-git-send-email-danielsh@tarsus.local2> 
	<91351.1468835277@hydra.kiddle.eu> 
	<20160720065421.GE28939@tarsus.local2> 
	<22468.1469114906@hydra.kiddle.eu> 
	<20160722062259.GB3457@tarsus.local2>
To: zsh-workers@zsh.org
Subject: Re: [PATCH v2] Re: [PATCH] _add-zle-hook-widget: New completion.
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii

On Jul 22,  6:22am, Daniel Shahaf wrote:
}
} _default appears to be undocumented.

There was a decision made at some point (*very* long ago, while Sven
was still actively inventing the compltion system) that the yodl doc
should only describe commands and functions etc. that an ordinary user
might employ in startup files, and all other details that developers
would use to write new parts of the completion system would only be
documented where developers could see it, e.g., in code comments.

Hence for example the complete lack of explanation of comptags and
comptry, even though they are at least *mentioned* in the yodl.

Sadly this didsn't really take new developers into account, because
you'd have to know what you were looking for before you could find
any doc for it, and not everything was adequately commented either.
Leaving us with a bunch of stuff that ought to be documented and
nobody with time to backfill it.

I learned the term "technical debt" recently ...