[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [GLISS] - alternative viewpoint
From: |
David Kastrup |
Subject: |
Re: [GLISS] - alternative viewpoint |
Date: |
Sun, 23 Sep 2012 13:28:11 +0200 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/24.2.50 (gnu/linux) |
James <address@hidden> writes:
> But I believe unless we now do something that is backward-incompatible
> with a (yet) undocumented function in the Notation or Learning manuals
> that we don't hold back the patch for the code, it would be nice to
> have it all documented as well, but that isn't always the case.
>
> The later footnote syntax was a case in point (I think) where we did
> change the syntax significantly enough that the old documentation
> would have been incorrect as opposed to incomplete/missing, we
> couldn't really push that on the users until had had been documented.
Well, it is unrealistic to expect both code and documentation to be
created entirely linearly, without the need of iterations.
In fact, sometimes it is while documenting things that it becomes clear
that an interface was chosen ill-advisedly. And then it sometimes makes
sense to restart the interface design.
I think it was during the documentation of the footnote stuff that we
came up with several examples (including use of s1*0/<>) that made clear
that we were better off refining the code rather than the documentation.
And that's fine. Changing code because it would be too embarrassing to
document it is certainly a better option than leaving it undocumented.
--
David Kastrup
- Re: [GLISS] - alternative viewpoint, (continued)
- Message not available
- Re: [GLISS] - alternative viewpoint, Thomas Morley, 2012/09/20
- Re: [GLISS] - alternative viewpoint, Marc Hohl, 2012/09/21
- Re: [GLISS] - alternative viewpoint, David Kastrup, 2012/09/21
- Re: [GLISS] - alternative viewpoint, Marc Hohl, 2012/09/22
- Re: [GLISS] - alternative viewpoint, Janek Warchoł, 2012/09/22
- Re: [GLISS] - alternative viewpoint, Graham Percival, 2012/09/23
- Re: [GLISS] - alternative viewpoint, Marc Hohl, 2012/09/23
- Re: [GLISS] - alternative viewpoint, Sue Daniels, 2012/09/24
- Re: [GLISS] - alternative viewpoint, David Kastrup, 2012/09/23
- Re: [GLISS] - alternative viewpoint, James, 2012/09/23
- Re: [GLISS] - alternative viewpoint,
David Kastrup <=
- Re: [GLISS] - alternative viewpoint, Jan Nieuwenhuizen, 2012/09/24
- Re: [GLISS] - alternative viewpoint, James, 2012/09/24
- Re: [GLISS] - alternative viewpoint, David Kastrup, 2012/09/24
- Re: [GLISS] - alternative viewpoint, Janek Warchoł, 2012/09/22
- Re: [GLISS] - alternative viewpoint, Janek Warchoł, 2012/09/17
- Re: [GLISS] - alternative viewpoint, Janek Warchoł, 2012/09/24
- Re: [GLISS] - alternative viewpoint, David Kastrup, 2012/09/15
- Re: [GLISS] - alternative viewpoint, Werner LEMBERG, 2012/09/15
- Re: [GLISS] - alternative viewpoint, Janek Warchoł, 2012/09/16
- Re: [GLISS] - alternative viewpoint, David Kastrup, 2012/09/16