Using the Design category
pieterh wrote on 10 Nov 2009 15:16 (Sticky)
This is the design section for new and changed features in Wikidot.
- Use the Whiteboard Area for all speculation, concepts, and raw designs. Do not start new designs directly in the design section. Only mature, peer-reviewed designs should move to the design section.
- Designs are closed when implemented.
- Designs should where possible look like documentation for the final feature.
- Please do not discuss on design threads directly but start subthreads for different aspects of designs, and close subthreads when they are done.
Here is how to design new functionality:
- Explain what you are trying to do, in high level terms (not in terms of code)
- Explain what functionality you used
- Explain why that did not do what you wanted (specific failures or issues)
- Allow the other party to respond - (a) do it differently or (b) need a change
- In case of (b), allow the other party to propose the change
- Review the change proposal, which becomes a soft contract
- Hope the work happens rapidly… :-)
- When it's ready, review the change and use it
- Confirm that you can now do what you want to achieve
Here is how not to design new functionality:
- Describe some feature and then explain why it's great.
Comments: 14
page revision: 6, last edited: 23 Dec 2009 16:09
Maybe we should close the comments on the design section and link each design to a thread here? We can't do it automatically, which is a bit of a pity; threads here are numbered, not named. But we can at least put the thread reference into the design sketch so people come here to discuss.
Portfolio
I would say for designs that are not discussed up till now… put a message on the blog and redirect them to here.
A - S I M P L E - P L A N by ARTiZEN a startingpoint for simple wikidot solutions.
I like it! I'm going to close the blog design section, we can work here instead.
Portfolio
So pieter is to blame for all of those emails Steven just made me get as notifications! :(
To be honest, I preferred this on the blog. In a way, this does make sense to have them here though.
~ Leiger - Wikidot Community Admin - Volunteer
Wikidot: Official Documentation | Wikidot Discord server | NEW: Wikiroo, backup tool (in development)
Actually, another thought — moving things here means that we've just lost all of those comments.
~ Leiger - Wikidot Community Admin - Volunteer
Wikidot: Official Documentation | Wikidot Discord server | NEW: Wikiroo, backup tool (in development)
dont forget If you think your post @ the blog were worth moving you can alway do this yourself… It was much work to manually copy and past the content… I will not do the comments by hand… but feel free.
There is always the possibility to see the old pages if you add /noredirect/true at the end of the url
expl.: http://blog.wikidot.com/design:14/noredirect/true
A - S I M P L E - P L A N by ARTiZEN a startingpoint for simple wikidot solutions.
I reverted the design:_template to show the comments again. It's true we've lost that discussion history… but afair most points were incorporated into the designs.
Portfolio
I think the projects forum is the natural home for the design specs and would like to thank Steven for doing the grunt work of moving such a lot of stuff over here. :-)
We needed something meaty to really test out the parent/child thread concept.
Sue
Yes, high five to Steven! :-)
The subthreads seem to be a little untamed… how do we feel those are working?
Portfolio
And what you mean by it.
I think (and that is also what I did) is that if a main thread is started, sub threads sould also be created and reffered to in the main thread…
well as in the "keyboard shortcuts" the subthread indicate how many comments so… is that what you wish to know?
Or do we need to make some kind of CSI so that @ one page you have an overview of al the subthreads that are made?
A - S I M P L E - P L A N by ARTiZEN a startingpoint for simple wikidot solutions.
This is currently done using breadcrumbs. The link is a bit small though…
~ Leiger - Wikidot Community Admin - Volunteer
Wikidot: Official Documentation | Wikidot Discord server | NEW: Wikiroo, backup tool (in development)
On another thread, Pieter said:
I think the discussion should occur here.
Sue
Please don't undo this structure. I think people just need a bit of time to get used to it. I certainly hated the never-ending discussion that went with the listpages design and couldn't digest any of it because of the lack of structure. It was quite hideous.
I think the sub-thread title should refer to the section of the design document that it is to discuss. I don't think the design page needs to be edited to reflect that, so long as an appropriate title is used for the sub-thread.
If you wish to disable the comments module from the design page (and I'd support that), there could be a single sub-thread on each design, specifically for all one-off comments (eg. "design name - general" maybe). I personally don't like the collapsible block idea for design page comments that is currently in action. It feels like we're being told off for daring to use it and that the comments hidden under the block are somehow forbidden fruit. Just my opinion, of course.
Sue
[[include :csi:something:page
titleName=++ Title of topic from main Thread|
siteName=%%currentSite%%]]
This CSI (it's a csi because it can be usefull for many sites) generates the following
This should be possible… I need to digg in the way of creating new pages or maybe the install fuction can be used… I don't know how to do this but is't an idea…
A - S I M P L E - P L A N by ARTiZEN a startingpoint for simple wikidot solutions.