APL Wiki:Content guidelines: Difference between revisions

Jump to navigation Jump to search
m
→‎Due weight: Better example: Dictionary of APL features mostly didn't make it to Dyalog
(→‎What is APL?: Try to avoid implying non-APL array languages shouldn't be documented)
m (→‎Due weight: Better example: Dictionary of APL features mostly didn't make it to Dyalog)
Line 44: Line 44:
Keep in mind that many APL users are not very visible to the outside world and don't publish anything about their usage (especially after the decline of the [[APL conference]]). For example, you are unlikely to see recent material about [[APL2]], but it is still widely used, and it's reasonable to think these users will look to the APL Wiki as a resource. As an editor you aren't expected to know every prominent language in order to contribute, but please think twice before removing material about a language you don't think is prominent. Evidence that the language is still in use might include major companies using it, active support forums, or significant development on the language indicating that it makes enough revenue to support this development. Significant historical use is also a sign, as usage of a particular APL rarely dies out quickly.
Keep in mind that many APL users are not very visible to the outside world and don't publish anything about their usage (especially after the decline of the [[APL conference]]). For example, you are unlikely to see recent material about [[APL2]], but it is still widely used, and it's reasonable to think these users will look to the APL Wiki as a resource. As an editor you aren't expected to know every prominent language in order to contribute, but please think twice before removing material about a language you don't think is prominent. Evidence that the language is still in use might include major companies using it, active support forums, or significant development on the language indicating that it makes enough revenue to support this development. Significant historical use is also a sign, as usage of a particular APL rarely dies out quickly.


A language can be prominent even if it is very rarely used, or in extreme cases never implemented. This is the case for research languages that are important in developing features later picked up by more prominent APLs. For example, [[A Dictionary of APL]], while only an incomplete description of how one APL might work, strongly influenced [[J]] and subsequently [[Dyalog APL]]. [[Extended Dyalog APL]], used infrequently in the [[code golf]] community, has also had a significant influence on [[Dyalog APL]]. The APL Wiki should include information about these languages because they will likely continue to influence APL's direction in the future. However, it's also important to make sure that this information, which is of theoretical interest, doesn't interfere with practical content. It should generally be placed lower in articles or sections of articles, and the text should make it clear that this material probably doesn't apply to the reader's APL of choice, usually by specifying which language or languages it is taken from.
A language can be prominent even if it is very rarely used, or in extreme cases never implemented. This is the case for research languages that are important in developing features later picked up by more prominent APLs. For example, [[Rationalized APL]], while only an incomplete description of how one APL might work, strongly influenced [[J]] and subsequently [[Dyalog APL]]. [[Extended Dyalog APL]], used infrequently in the [[code golf]] community, has also had a significant influence on [[Dyalog APL]]. The APL Wiki should include information about these languages because they will likely continue to influence APL's direction in the future. However, it's also important to make sure that this information, which is of theoretical interest, doesn't interfere with practical content. It should generally be placed lower in articles or sections of articles, and the text should make it clear that this material probably doesn't apply to the reader's APL of choice, usually by specifying which language or languages it is taken from.


== Dialect-specific pages ==
== Dialect-specific pages ==

Navigation menu