Personal tools
You are here: Home development PDDP draft reference designs

Edit history

Edit: -1 of 1
Time: 2007-02-13 08:10:36
Note: /pd/pd/dev/pddp/DraftReferenceDesigns/edit "changed to tar.bz2"

Here are a few draft proposal designs for PDDP templates. The patches have only been tested on OSX. 

**Template 1** (The same style as the pixelTANGO help)




    * The headers look less junky than the other templates

    * indenting helps with sub-options readability

    * examples are isolated and easier to focus on.

    * standard header has the overview

    * More info along the bottom, a canvas "?" icon could work here.


    * Pretty wide

    * Width limitation is not great for example patches.

    * many canvases (more laborious)

    * does not scale (downwards) very easily

**Template 2** (A minimalist change to the original PDDP template)




    * few canvases, very easy to make

    * Headers separate from text

    * First thing to be seen is the object in instantiation.


    * Upper case is HARDER to read than lowercase, I think only meta-data should be upper-case. 

    * examples are harder to isolate, look pretty cramped in. 

    * Meta-data at the bottom seems awkward

    * spacing of headers on the left are a little hard to read (structurally), sub-options are not very clear due to the lack of indenting

    * Only scales downwards easily

**Template 3** (A variation on template-2 with ideas from template-1)




    * Looks really clean and easy to read.

    * looks less cramped using header-bars that span patch width

    * larger more spaced area for patches

    * page header and footer look consistent and frame the page

    * less canvases than template-1 (easier to make)


    * the colour of the subheadings help, but some kind of indentation would make the subheadings look more like sub-headings. 

    * More canvases than template-2

    * only scales downwards easily

From alx2 Fri May 6 20:46:45 +0200 2005
From: alx2
Date: Fri, 06 May 2005 20:46:45 +0200
Subject: comments from the GridFlow doc folks
Message-ID: <>

(alx2) Here are our comments:

We are working on docs for GridFlow and we would like to adopt the same format as the PDDP.  We like the verbose help patches.  One main difference we would like to see is to have the patch featured at the top, after the declaration of the object.  That is why Template 1 appeals to us but scrolling down might be preferable to hiding the patch below the help patch (template 1 is pretty wide).  We think that the help patches should be narrower. Somehow the metadata is bulky at the top, we would rather place it at the end.  We would like to keep the 'see also' out of the subpatch, clicking directly on these related objects is such a nice feature, and usually it does not need more than one line.

**Template 4** (Based on feedback on Template 3)



    * Moved Meta-Data to bottom

    * Moved example to top

    * Lined up headings (lowercase) & indented sub-heading canvases

From tfbb Tue May 10 13:01:24 +0200 2005
From: tfbb
Date: Tue, 10 May 2005 13:01:24 +0200
Subject: comments from the GridFlow doc folks
Message-ID: <>
In-Reply-To: <>

My fav is #1, because it is the most clearly arranged one: all the information can be grasped at the first glance. The width of the patch is not really an issue in my opinion, I guess we all work at 1024x768 at least ... However, I do agree with the gridflow people that moving the metadata to the bottom would be a good idea.

From alx2 Tue May 10 16:01:33 +0200 2005
From: alx2
Date: Tue, 10 May 2005 16:01:33 +0200
Subject: where should the help patch go?
Message-ID: <>
In-Reply-To: <>

Hiya, if width is not an issue, then we agree that #1 is viable.  Ben, does it lead to a lot of open space under the patch if the text that accompanies it is quite long? How do you deal with that in the Pixel Tango help?


From bbogart Tue May 10 17:52:14 +0200 2005
From: bbogart
Date: Tue, 10 May 2005 17:52:14 +0200
Subject: where should the help patch go?
Message-ID: <>
In-Reply-To: <>

In the pixelTANGO help patches there are few "patches" in the patch area, since the modules are so high-level. They only show one or two abstractions connected at a time see: "PixelTANGO":

The main problems with template-1 are that the patch area is very constrained. It would be hard to put a more complex patch here. So it could work as a "reference" template but not as an "all_about" template. The second problem is that it is much more laborious than the other templates, I'm worried it may not be adopted by all developers. Thirdly Its much easier to add another text column if one needed more space, but the example patch area is no so expandable. (wow it could be cool to specify padding and grids in PD so that the canvas could automatically expand with a change in window size.) The biggest improvement with template-4 is that the patch area can easily be expanded to any size, up to the point similar to template-1 where the patch is next to the text column, but is the same width. I wish more people (developers) would make comments. I'll try and work on a version of template-1 as template-5 sometime today.  

**Template 5** (Based on feedback on Template 1)



    * Moved Meta-Data to bottom

From alx2 Wed May 11 21:32:21 +0200 2005
From: alx2
Date: Wed, 11 May 2005 21:32:21 +0200
Subject: more comments from the #dataflow channel
Message-ID: <>

Hiya, we just had a look at the newest templates and here are some comments :
<mamalala> oh, and personally, i would put the "arguments" section before the in/outlet sections .... mabye next to the "usage" field ......
<mamalala> in the example there is for inlets "Left" and "Right" ..... for consitency, it should be numbered, maybe with a "Leftmost" or "Rightmost" for the first/last
<mamalala> i mean, how would you describe an object with 5 inlets ? left, right from left, middle ..... ?
<mamalala> just a question: you said the colored bars & fields are made using canvases .... maybe it would be an idea to just create a "comment" object ? one that has colours & font definitions ?
<mamalala> left side is fine, for me it is easier to read .....
<alx1> so it is really a choice between #4 and #5
<alx1> ok cool
<alx1> and it still lets people see the patch, it was on the bottom before
<alx1> or in one of the proposed templates
<mamalala> with the text below the example, it is more like a book page ..... plus, it makes the eyes jump up & down while reading, whereas the left-sided one gives it "all in one view"
<mamalala> meaning that is easier to find the line you where reading again, after looking at the example .....
<mamalala> (at least for me)
<darsha> alx: Steph and I both think that #4 is the best.  It is clearly laid out and is a more versatile design (works with long and short text components).  Rob likes it too.
<mamalala> but that might also be my bias because most of the jmax patches were arranged that way (example left, text right)
<alx1> darsha: but it is true that for a patch with less text, #5 looks good
<darsha> mamalala: True, but we found that the lines (mini canvases) dividing up the different sections are a bit distracting/ busy


There is a spelling mistake with CATEGORY.



From alx2 Wed May 11 21:34:25 +0200 2005
From: alx2
Date: Wed, 11 May 2005 21:34:25 +0200
Subject: more comments from the #dataflow channel
Message-ID: <>
In-Reply-To: <>

sorry the wiki's formatting removed the names within brackets as well as the new lines.  Taking part in the discussion were mamalala, darsha, stephanie, rob, matju and myself.

From bbogart Mon May 16 22:48:08 +0200 2005
From: bbogart
Date: Mon, 16 May 2005 22:48:08 +0200
Subject: more comments from the #dataflow channel
Message-ID: <>
In-Reply-To: <>

I'm a little confused about the template numbering here, I thought the two-column thing (template-1) was the forrunner, and I've based template-5 and template-6 on this. Is template-4 now on top? If so please let me know and I'll revise template-6 into the style of template-4. 

**Template 6** (Based on feedback on Template 4&5)



    * Moved Meta-Data to [pd META]

    * Changed colour of high-lights to makes things less busy looking

    * Changed wording of inlets 0-n where "0" is left-most

    * Removed the "HELP: float" line entirely

    * Changed "links" to other patches, added "hyperlink" stand-ins

From alx2 Tue May 17 18:12:37 +0200 2005
From: alx2
Date: Tue, 17 May 2005 18:12:37 +0200
Subject: template 6 looks good!
Message-ID: <>

I understand your confusion, I was placing comments from our chat and there were two opinions voiced.  We all now agree that the two-column layout is the best.  We also agree that the change in colour lightens the layout.  We like this layout but wonder if the 'see also' or 'more info' is entirely removed or simply not needed for this particular patch.

In any case, we are going ahead with the same layout for the GridFlow reference.  Thanks for this work :-).

From bbogart Tue May 17 23:34:36 +0200 2005
From: bbogart
Date: Tue, 17 May 2005 23:34:36 +0200
Subject: template 6 looks good!
Message-ID: <>
In-Reply-To: <>

Good to hear about consensus I think HC also was happy with this direction, no specific comments about template-6 from him yet. 'see also' and 'more info' will now be pddplinks that will directly open -example & -about patches, as well as html documents. I'm not personally sure how this fits into the templatge, if these links should be up to the developer. I think a link to a more complex example and a related -about patch should be required. What do you all think?

**Template 7c** (Result from Nov 22nd Meeting)



    * Used HCS's variation on template-4 as a starting point

    * more blocking to separate content, and still compressing vertically

    * added "bullet" canvases, and seperation for each inlet. 

    * inlets are labelled as "0" to "n" where 0 is leftmost. This template will work for objects with more than two *lets

    * added Darsha's canvas's to highlight the float objects in the example patches

    * Put meta at top so that all the meta-data stuff (which includes the DESCRIPTION, are at the top)

    * Link to PDDP contents at the bottom, for every reference page.

    * Made the content a little more consistant, note how the number of arguments used to be expressed. 

**Template 8** (7c plus HCS additions)



    * Contents, Glossary, Multi-page

**Template 8b** (8 plus an implimentation of multi-page)


    "page abstraction":pddp-drafts/pddp_page

    * The abstraction deals with jumping to the nest page from the current page, also tells the patch how many pages there are. 

From unknown Tue Nov 29 20:24:11 +0100 2005
Date: Tue, 29 Nov 2005 20:24:11 +0100
Subject: META
Message-ID: <20051129202411+0100@>

I think the meta data (CATAGORY KEYWORDS & DESCRIPTION) should only be in the reference parent, not on each page. 

From unknown Tue Nov 29 20:26:52 +0100 2005
Date: Tue, 29 Nov 2005 20:26:52 +0100
Subject: BACK
Message-ID: <20051129202652+0100@>

add a back button for pddp_page

From unknown Tue Nov 29 20:27:15 +0100 2005
Date: Tue, 29 Nov 2005 20:27:15 +0100
Subject: COLOUR
Message-ID: <20051129202715+0100@>


**Template 8c** (8b plus paler yellow and prev/next bangs)


    "page abstraction":pddp-drafts/pddp_page

**Template 9** (8c little changes)



**Template 10**



    This is an attempt at making a web-style top-menu nav.

Powered by IEM Powered by Plone Section 508 WCAG Valid XHTML Valid CSS Usable in any browser