J/HouseStyle: Difference between revisions
→style guidelines
Line 31:
::<div id="1"><sup>1</sup>Except in the case where a Task highlights an aspect of syntax or a language feature, which is best demonstrated, then described in English, e.g. [[Exponentiation_operator#J|exponentiation operator]].</div>
:::I agree with much of what you say - particularly that full descriptions/explanations of the code don't belong on the main task page. However I do think that a slight increase in the verbosity and amount of comments will help decrease the perceived impenetrability of "standard" J solutions.
:::Using the [[Zig Zag]] task as an example, I think something like one of the solutions in your excellent explanation on the Talk page would be both intriguing and more likely to encourage further study by non-J users, than the current solutions. i.e.
<lang j>
zigzag=: $ [: /:@; [: <@|.`</. i.
</lang>
:::vs.
<lang j>
reshape=: $
reorder=: /:@;
antidiags=: <@|.`</.
integers=: i.
zigzag=: reshape [: reorder [: antidiags integers
</lang>
:::or perhaps:
<lang j>
reorder=: /:@;
antidiags=: <@|.`</.
zigzag=: $ [: reorder [: antidiags i.
</lang>
:::--[[User:Tikkanz|Tikkanz]] 22:46, 14 October 2009 (UTC)
----
Thanks to to both of you. I'm going to write up my own views in the next couple of days, and start recommending specific guidlines. Feel free to change them and push them in any direction you see fit. If I get time, I'll try to collect here the views that others expressed in the [http://www.jsoftware.com/pipermail/programming/2009-October/016537.html corresponding J forum thread].
| |||