For mi.yodeya, I wrote up a jargon guideline (lightly adapted below) intended to make content on the site accessible to as many interested people as possible. It was not followed very closely on m.y, and I've had second thoughts about how far a site primarily for "experts/professionals" (as SE sites are supposed to be) needs to go to define terms for the benefit of novices.
Should we have a jargon policy/guideline, and what should it be?
The following is the official guideline for use of jargon and specialized terms on mi.yodeya. It is not meant as a strict policy and is subject to change. We welcome comments and suggestions in the comments.
When writing questions and answers on mi.yodeya, the overall guiding principle you should have in mind is:
Will any English speaker who is interested in this content be able to understand what it means without additional research?
Here are some guidelines that come out of this:
Don't use non-English terms gratuitously. If there's an English term that conveys your meaning smoothly, just use it.
No: How much should we pay people involved in chinuch?
Not even: How much should we pay people involved in chinuch (Jewish education)?
Yes: How much should we pay people involved in Jewish education?
If you use a non-English or specialized term that your readers might not know, define it the first time or link to a defintion. You can keep jargon in a question title as long as you define or link it in the body.
No: Turning on a light might be prohibited under the Melacha of Makeh Bapatish.
OK: Turning on a light might be prohibited under the Melacha (category of creative labor) of Makeh Bapatish (finishing touch).
Better: Turning on a light might be prohibited under the Melacha of Makeh Bapatish.
Terms that anyone who may be interested in the content would know are fine by themselves.
Fine: How should I purse my lips when blowing a shofar? No one will care about this if they don't already know what a shofar is.
Not so fine: The Yom Kippur service concludes with a shofar blast. All a person needs to know to potentially care about this is that there's a holiday called Yom Kippur.
Fixed: The Yom Kippur service concludes with a shofar blast.