we are filling the gaps in the Kauri forms reference, and wondering if
a visual representation of the fconf object would make things more
clear.
Example:
instead of writing
This image is generated by specifying a BNF grammar (which
is cool for us, nerds). But is it more clear than the
text version?
What do you think?
Freya
--
You received this message because you are subscribed to the Google Groups "Kauri Discussions" group.
To post to this group, send email to kauri-discuss@googlegroups.com.
To unsubscribe from this group, send email to kauri-discuss+unsubscribe@googlegroups.com.
For more options, visit this group at http://groups.google.com/group/kauri-discuss?hl=en.
I, NOT being a nerd, don't understand anything about the image.
(slightly exaggerated but the text-version is more clear to me)
Wkr,
Sofie
Freya Impens schreef:
Hi
all
we are filling the gaps in the Kauri forms reference, and wondering if
a visual representation of the fconf object would make things more
clear.
Example:
instead of writing
--
You received this message because you are subscribed to the Google Groups "Kauri Discussions" group.
To post to this group, send email to kauri-discuss@googlegroups.com.
To unsubscribe from this group, send email to kauri-discuss+unsubscribe@googlegroups.com.
For more options, visit this group at http://groups.google.com/group/kauri-discuss?hl=en.
> I, NOT being a nerd, don't understand anything about the image.
> (slightly exaggerated but the text-version is more clear to me)
> Wkr,
> Sofie
> Freya Impens schreef:
>> Hi all
>> we are filling the gaps in the Kauri forms reference, and wondering >> if a visual representation of the fconf object would make things more >> clear.
>> Example:
>> instead of writing
>> This image is generated by specifying a BNF grammar (which is cool >> for us, nerds). But is it more clear than the text version?
>> What do you think?
>> Freya
>> -- >> You received this message because you are subscribed to the Google >> Groups "Kauri Discussions" group.
>> To post to this group, send email to kauri-discuss@googlegroups.com.
>> To unsubscribe from this group, send email to >> kauri-discuss+unsubscribe@googlegroups.com.
>> For more options, visit this group at >> http://groups.google.com/group/kauri-discuss?hl=en.
> -- > You received this message because you are subscribed to the Google > Groups "Kauri Discussions" group.
> To post to this group, send email to kauri-discuss@googlegroups.com.
> To unsubscribe from this group, send email to > kauri-discuss+unsubscribe@googlegroups.com.
> For more options, visit this group at > http://groups.google.com/group/kauri-discuss?hl=en.
-- You received this message because you are subscribed to the Google Groups "Kauri Discussions" group.
To post to this group, send email to kauri-discuss@googlegroups.com.
To unsubscribe from this group, send email to kauri-discuss+unsubscribe@googlegroups.com.
For more options, visit this group at http://groups.google.com/group/kauri-discuss?hl=en.
I think these syntax diagrams make it go down easier then BNF...
... but probably will never free us from having to provide pure textual 'samples' from where people can copy-paste.
I think a formal notation (BNF or diagram) does a far better job at expressing recursion and recurring syntax-features then just some samples...
-marc=
Freya Impens wrote:
> Hi all
> we are filling the gaps in the Kauri forms reference, and wondering if a > visual representation of the fconf object would make things more clear.
> Example:
> instead of writing
> FieldType : {
> base : FieldType,
just nitpicking maybe, but probably this should be "FieldTypeRef" (only string allowed here?)
> This image is generated by specifying a BNF grammar (which is cool for > us, nerds). But is it more clear than the text version?
> What do you think?
> Freya
> -- > You received this message because you are subscribed to the Google > Groups "Kauri Discussions" group.
> To post to this group, send email to kauri-discuss@googlegroups.com.
> To unsubscribe from this group, send email to > kauri-discuss+unsubscribe@googlegroups.com.
> For more options, visit this group at > http://groups.google.com/group/kauri-discuss?hl=en.
-- You received this message because you are subscribed to the Google Groups "Kauri Discussions" group.
To post to this group, send email to kauri-discuss@googlegroups.com.
To unsubscribe from this group, send email to kauri-discuss+unsubscribe@googlegroups.com.
For more options, visit this group at http://groups.google.com/group/kauri-discuss?hl=en.
I'm afraid the usage of such images might make the barrier for maintaining
the documentation higher, unless these are auto-generated by some daisy
extension or if updates to these will be seldom (not sure if this is for the
base syntax or for all specific controls too).
On Tue, Apr 20, 2010 at 3:23 PM, Freya Impens <fr...@outerthought.org>wrote:
> we are filling the gaps in the Kauri forms reference, and wondering if a
> visual representation of the fconf object would make things more clear.
> Example:
> instead of writing
> This image is generated by specifying a BNF grammar (which is cool for
> us, nerds). But is it more clear than the text version?
> What do you think?
> Freya
> --
> You received this message because you are subscribed to the Google Groups
> "Kauri Discussions" group.
> To post to this group, send email to kauri-discuss@googlegroups.com.
> To unsubscribe from this group, send email to
> kauri-discuss+unsubscribe@googlegroups.com<kauri-discuss%2Bunsubscribe@goog legroups.com>
> .
> For more options, visit this group at
> http://groups.google.com/group/kauri-discuss?hl=en.
-- You received this message because you are subscribed to the Google Groups "Kauri Discussions" group.
To post to this group, send email to kauri-discuss@googlegroups.com.
To unsubscribe from this group, send email to kauri-discuss+unsubscribe@googlegroups.com.
For more options, visit this group at http://groups.google.com/group/kauri-discuss?hl=en.
Ha, I must admit that the 'right to left' nature of the image puzzled me also for a while.
But I like the idea, though it will require some extra effort to keep the images in sync with the codebase and the text snippets (which we certainly should keep for copy-paste and other purposes).
Bruno Dumon wrote:
> It seems strange the image is 'right to left'.
> I'm afraid the usage of such images might make the barrier for > maintaining the documentation higher, unless these are auto-generated > by some daisy extension or if updates to these will be seldom (not > sure if this is for the base syntax or for all specific controls too).
> On Tue, Apr 20, 2010 at 3:23 PM, Freya Impens <fr...@outerthought.org > <mailto:fr...@outerthought.org>> wrote:
> Hi all
> we are filling the gaps in the Kauri forms reference, and
> wondering if a visual representation of the fconf object would
> make things more clear.
> Example:
> instead of writing
> This image is generated by specifying a BNF grammar (which is
> cool for us, nerds). But is it more clear than the text version?
> What do you think?
> Freya
> -- > You received this message because you are subscribed to the Google
> Groups "Kauri Discussions" group.
> To post to this group, send email to
> kauri-discuss@googlegroups.com
> <mailto:kauri-discuss@googlegroups.com>.
> To unsubscribe from this group, send email to
> kauri-discuss+unsubscribe@googlegroups.com
> <mailto:kauri-discuss%2Bunsubscribe@googlegroups.com>.
> For more options, visit this group at
> http://groups.google.com/group/kauri-discuss?hl=en.
> -- > Bruno Dumon
> Outerthought
> http://outerthought.org/ > -- > You received this message because you are subscribed to the Google > Groups "Kauri Discussions" group.
> To post to this group, send email to kauri-discuss@googlegroups.com.
> To unsubscribe from this group, send email to > kauri-discuss+unsubscribe@googlegroups.com.
> For more options, visit this group at > http://groups.google.com/group/kauri-discuss?hl=en.
-- You received this message because you are subscribed to the Google Groups "Kauri Discussions" group.
To post to this group, send email to kauri-discuss@googlegroups.com.
To unsubscribe from this group, send email to kauri-discuss+unsubscribe@googlegroups.com.
For more options, visit this group at http://groups.google.com/group/kauri-discuss?hl=en.
I've used a EBNF-to-diagram tool to generate the image. There seems no way
to generate this left-to-right (if you try to do it yourself, you will
notice it *is* easier from right to left :)).
But I 'll try to find something else, but a generator is easier to maintain
then drawing the images ourself biensur.
Ha, I must admit that the 'right to left' nature of the image puzzled me
> also for a while.
> But I like the idea, though it will require some extra effort to keep the
> images in sync with the codebase and the text snippets (which we certainly
> should keep for copy-paste and other purposes).
> wkr,
> Jeroen
> Bruno Dumon wrote:
> It seems strange the image is 'right to left'.
> I'm afraid the usage of such images might make the barrier for maintaining
> the documentation higher, unless these are auto-generated by some daisy
> extension or if updates to these will be seldom (not sure if this is for the
> base syntax or for all specific controls too).
> On Tue, Apr 20, 2010 at 3:23 PM, Freya Impens <fr...@outerthought.org>wrote:
>> Hi all
>> we are filling the gaps in the Kauri forms reference, and wondering if a
>> visual representation of the fconf object would make things more clear.
>> Example:
>> instead of writing
>> This image is generated by specifying a BNF grammar (which is cool for
>> us, nerds). But is it more clear than the text version?
>> What do you think?
>> Freya
>> --
>> You received this message because you are subscribed to the Google Groups
>> "Kauri Discussions" group.
>> To post to this group, send email to kauri-discuss@googlegroups.com.
>> To unsubscribe from this group, send email to
>> kauri-discuss+unsubscribe@googlegroups.com<kauri-discuss%2Bunsubscribe@goog legroups.com>
>> .
>> For more options, visit this group at
>> http://groups.google.com/group/kauri-discuss?hl=en.
> --
> Bruno Dumon
> Outerthought
> http://outerthought.org/ > --
> You received this message because you are subscribed to the Google Groups
> "Kauri Discussions" group.
> To post to this group, send email to kauri-discuss@googlegroups.com.
> To unsubscribe from this group, send email to
> kauri-discuss+unsubscribe@googlegroups.com.
> For more options, visit this group at
> http://groups.google.com/group/kauri-discuss?hl=en.
> --
> You received this message because you are subscribed to the Google Groups
> "Kauri Discussions" group.
> To post to this group, send email to kauri-discuss@googlegroups.com.
> To unsubscribe from this group, send email to
> kauri-discuss+unsubscribe@googlegroups.com<kauri-discuss%2Bunsubscribe@goog legroups.com>
> .
> For more options, visit this group at
> http://groups.google.com/group/kauri-discuss?hl=en.
-- You received this message because you are subscribed to the Google Groups "Kauri Discussions" group.
To post to this group, send email to kauri-discuss@googlegroups.com.
To unsubscribe from this group, send email to kauri-discuss+unsubscribe@googlegroups.com.
For more options, visit this group at http://groups.google.com/group/kauri-discuss?hl=en.
On Mon, Apr 26, 2010 at 10:45 PM, Freya Impens <fr...@outerthought.org>wrote:
> I've used a EBNF-to-diagram tool to generate the image. There seems no way
> to generate this left-to-right (if you try to do it yourself, you will
> notice it *is* easier from right to left :)).
> But I 'll try to find something else, but a generator is easier to maintain
> then drawing the images ourself biensur.
Or maybe through some nifty BNF>XML>SVG hack? We have all the Cocoon
plumbing at our disposal.
Steven.
-- Steven Noels http://outerthought.org/ Outerthought Open Source Java & XML
stevenn at outerthought.org Makers of the Daisy CMS
-- You received this message because you are subscribed to the Google Groups "Kauri Discussions" group.
To post to this group, send email to kauri-discuss@googlegroups.com.
To unsubscribe from this group, send email to kauri-discuss+unsubscribe@googlegroups.com.
For more options, visit this group at http://groups.google.com/group/kauri-discuss?hl=en.
