J/HouseStyle: Difference between revisions

Content added Content deleted
(→‎{{header|J}}: regarding multiple alternative solutions (e.g. tacit vs explicit))
Line 88: Line 88:
'''Solution''':<lang j>name =: a succinct but legible definition NB. Possibly references other defined names,
'''Solution''':<lang j>name =: a succinct but legible definition NB. Possibly references other defined names,
NB. as Tikkanz showed, where each name encapsulates a single,
NB. as Tikkanz showed, where each name encapsulates a single,
NB. but powerful thought. No trivial names.</lang>
NB. but powerful thought. No trivial names.
</lang>

'''Alternative solution (''style'')''':<lang j>name =: alternative, equivalent solution in a different style
NB. For example, explicit as opposed to tacit. ALWAYS lead with the preferred
NB. (usually shortest) solution; alternative solutions are merely showcases.
NB. Note also that the exact same name is assigned, indicating all solutions
NB. are identical, and could equally be the referent of the Example section.
NB. Do not present too many solutions; keep the J entry short and sweet.
NB. Further solutions can always be linked to.</lang>


'''Example''': <lang j>name argument NB. Example usages; exercise all the interesting aspects,
'''Example''': <lang j>name argument NB. Example usages; exercise all the interesting aspects,