On 2012/11/22 12:42:04, Trevor Daniels wrote:
[...]
The Extending Manual is the place for explanations useful to
developers. Granted this is rather embryonic at present, due
mainly to a dearth of knowledgeable people willing to contribute
to it. It would benefit greatly from further input ;)
http://codereview.appspot.com/6845078/diff/1/Documentation/notation/input.itely
File Documentation/notation/input.itely (right):
http://codereview.appspot.com/6845078/diff/1/Documentation/notation/input.itely#newcode1250
Documentation/notation/input.itely:1250: [@var{direction}] \footnote
Reviewers: dak,
http://codereview.appspot.com/6845078/diff/1/Documentation/notation/input.itely
File Documentation/notation/input.itely (right):
http://codereview.appspot.com/6845078/diff/1/Documentation/notation/input.itely#newcode1250
Documentation/notation/input.itely:1250:
On 2012/11/22 11:04:00, Trevor Daniels wrote:
That's always the problem when you try to explain rather
than just showing what to do, especially with a messy
interface like this one.
Basically we got one interface now, with two essentially different
behaviors depending on whether the last
On 2012/11/22 11:04:00, Trevor Daniels wrote:
[...]
I might chop the explanations - users in
general don't need this level of understanding.
Well, in the past I sometimes was beaten by the not explained why? and
how? in the docs.
So I'd always vote for deeper explanations in an additional
On 2012/11/22 11:39:30, thomasmorley65 wrote:
So I'd always vote for deeper explanations in an additional paragraph.
Might be
I have some sympathy with this view, but the primary purpose
of the Notation Reference is to tell users /how to engrave/
their music in as simple and straightforward