The Jargon File is a living document

The Jargon File is a living document, an evolving resource chronicling the language and culture of computer hackers. If you are a hacker, a linguist, a cultural anthropologist, or just an intelligent person with something relevant to contribute, it's your right and privilege to help it grow.

The Jargon File has always been maintained by volunteers. There's no secret password or arcane protocol to getting an entry added or changed. Send your suggested new entries, or changes to old ones, to jargon@thyrsus.com.

Who the editors are

The editorial "we" used below refers to the current volunteer editor of the Jargon File and maintainer of the Jargon File Resource Pages, Eric S. Raymond, and the members of two mailing lists who assist and advice him.

One mailing list, jargon-friends, is closed, it consists of the coauthors of the original 1983 Hacker's Dictionary, Eric Raymond, and a publisher representative. The other, jargon-helpers, is open to all interested parties; mail to jargon-helpers@ccil.org to join.

The editorship of the File has changed hands before and will again. If you are steeped in hacker lore, expert by and fascinated with the language game, and think you might be up to the job, please join jargon-helpers and show us.

How we evaluate suggestions

Here are the questions we ask ourselves when we read what people send us:

Is it really hacker slang?
An entry may be outside the File's scope if it's established technical jargon that you'd find in a computer science or engineering textbook. Or if it's mainstream slang used by hackers but not unique to hackers.

We are interested in expanding the File's range of technical specialties covered. There are doubtless rich veins of jargon yet untapped in the scientific computing, graphics, and networking hacker communities; also in numerical analysis, computer architectures and VLSI design, language design, and many other related fields.

We are not interested in straight technical terms explained by textbooks or technical dictionaries unless an entry illuminates `underground' meanings or aspects not covered by official histories. We are also not interested in `joke' entries --- there is a lot of humor in the file but it must flow naturally out of the explanations of what hackers do and how they think.

Is it really in live use?
We don't want `slang' that's just the private coinage of one or two people. We like to have two independent cites for each entry (by `independent' we mean that they don't come from two close friends or people with adjacent desks).

It is OK to submit items of jargon you have originated if they have spread to the point of being used by people who are not personally acquainted with you -- but remember the ``two cities'' rule above.

How much provenance and usage information is attached?
All other things being equal, your entry will much more likely to make it if you include not only the raw definition, but an at least plausible story about where and by whom the term is used, and how it originated. Some indication of the years in which it was or is current is also valuable. References to actual usage via URLs and/or DejaNews pointers are particularly welcomed.

Will it help a newbie understand hackers and the net better?
One of the Jargon File's functions is to be a guide for the perplexed newbie (and acculturate newbies who are proto-hackers into our grand tradition). Entries get points for illuminating aspects of hacker culture that newbies need to know, even if they seem obvious to long-time net habitues or have become so ingrained in veteran hackers that they're reflexive.

Does it show the hacker spirit?
The hacker spirit is like that famous judge's definition of pornography; we don't know how to define it, but we know it when we see it. It's partly intelligence, partly technical competence, partly wry humor, partly an unabashed dedication to creativity and honesty and intellectual exploration, all wrapped up in a tinkerer's itch to build something that actually works. Every good thing the Jargon File can accomplish depends on showing the hacker spirit.

We use Web search engines and DejaNews to check for live usage of terms. If we can't find your term in live use, you'll have to work pretty hard to persuade us that there's a real population that has it in production vocabulary.

How we edit entries

All contributions and suggestions will be considered donations to be placed in the public domain as part of the Jargon File, and may be used in subsequent paper editions. Submissions may be edited for accuracy, clarity and concision.

We fix spelling, syntax, and usage errors. We edit (usually lightly) to get entries into a uniform style we think of as "highest-quality hacker" -- informal and only loosely bound by conventional usage, but pithy, precise, and punchy.

We do not generally leave proper names in entries; this is to try to keep getting into the Jargon File from becoming an ego contest. The way we like to put it is that you can't get your name mentioned in the File unless you're already so famous that most readers will recognize it.

However, this doesn't mean you should leave proper names out of etymologies and the like. We keep mail archives which scholars may someday excavate for more information (someday we'll probably HTMLize them and link them to the Jargon File itself).

Should I expect a reply?

The editor(s) may be too busy to reply -- this does not mean you have been ignored. On the contrary, it usually means your material has been incorporated.

You may get a reply that says your jargon has been placed ``on watch''. This means the editors have been unable to confirm independent use of the term elswhere, but are keeping an eye out for a second independent submission.

When do old entries get deleted?

Old entries usually get deleted when (a) they're no longer in live use, and (b) they're not of sufficient interest as history. Occasionally an entry will get deleted when usage searches via DejaNew/AltaVista etc. suggest it was never really live in the first place, or that it's actually mainstream.


Eric S. Raymond <esr@snark.thyrsus.com>