2,951
edits
APL Wiki:Content guidelines: Difference between revisions
Jump to navigation
Jump to search
APL Wiki:Content guidelines (view source)
Revision as of 20:10, 8 February 2021
, 20:10, 8 February 2021→Dialect-specific pages: Pages about multiple dialects
m (Fix a red link) |
(→Dialect-specific pages: Pages about multiple dialects) |
||
| Line 51: | Line 51: | ||
In a dialect-specific article, you can assume (because you have told the reader) that the reader knows the page pertains to one APL only. This means it's acceptable to use terms like [[Disclose]] that are ambiguous in general but have only one meaning in the context of that APL, or terms like [[tradfn]] that many parts of the APL community don't use. Despite this, your primary aim should be to make the article useful for a general reader, who might never have heard of this APL. Use terminology which would be most readable for the wider APL community while remaining intelligible from the specific dialect's perspective. If there is no single term that fits, use a dialect-specific one but clarify by mentioning an identical or analogous term in parentheses. | In a dialect-specific article, you can assume (because you have told the reader) that the reader knows the page pertains to one APL only. This means it's acceptable to use terms like [[Disclose]] that are ambiguous in general but have only one meaning in the context of that APL, or terms like [[tradfn]] that many parts of the APL community don't use. Despite this, your primary aim should be to make the article useful for a general reader, who might never have heard of this APL. Use terminology which would be most readable for the wider APL community while remaining intelligible from the specific dialect's perspective. If there is no single term that fits, use a dialect-specific one but clarify by mentioning an identical or analogous term in parentheses. | ||
The guidelines about dialect-specific terminology extend to pages about a group of dialects or languages if these share similar terminology (such as [[K]] derivatives). However, if an article pertains to multiple dialects with very different terminology, choose a single set of terminology in order to make the article consistent rather than switching between them. This may be either the most well-known of the dialects in question, or terminology from a mainstream APL or widely used across APLs. | |||
For articles about a specific dialect, not just pertaining to it (such as [[A+]] or [[Dyalog APL versions]]), the emphasis is in the other direction: '''always give a language's preferred terminology on its own page''' when there is a clear preference. In order to make the page usable for general APL programmers, clarify terminology which is not obvious in parentheses: for example, the page on [[K]] lists the function "flip ([[Transpose]])". | For articles about a specific dialect, not just pertaining to it (such as [[A+]] or [[Dyalog APL versions]]), the emphasis is in the other direction: '''always give a language's preferred terminology on its own page''' when there is a clear preference. In order to make the page usable for general APL programmers, clarify terminology which is not obvious in parentheses: for example, the page on [[K]] lists the function "flip ([[Transpose]])". | ||