J/HouseStyle: Difference between revisions

→‎style guidelines: suggestion: {Obscure} template
(thanks & response)
(→‎style guidelines: suggestion: {Obscure} template)
Line 21:
http://rosettacode.org/wiki/User_talk:Dkf#Your_discussion_about_J
in that more detailed comments and algorithm explanations are required for every code example in the RC forum, since the whole point is to help readers unfamiliar with that specific language understand what is going on in the code. The more unconventional a language is, the more explanation required. Hence, J examples in RC should display good coding practices (for J) in the example, but that code example should also be accompanied with thorough explanations and comments, all of which should be more thorough than if the audience was just J programmers. For that matter, this advice should be applied for all RC code examples. Teledon 8:47am 13 October 2009
 
:This is great advice! Would it help to have something like an {Obscure} template readers could use to tag examples which they find difficult to understand? --[[User:IanOsgood|IanOsgood]] 17:10, 14 October 2009 (UTC)
 
----
Anonymous user