On 6/1/06, <b class="gmail_sendername">Ben Wilson</b> <<a href="mailto:dausha@gmail.com">dausha@gmail.com</a>> wrote:<div><span class="gmail_quote"></span><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
On 6/1/06, <a href="mailto:christian.ridderstrom@gmail.com">christian.ridderstrom@gmail.com</a><br><<a href="mailto:christian.ridderstrom@gmail.com">christian.ridderstrom@gmail.com</a>> wrote:<br>> On Wed, 31 May 2006, Neil Herber wrote:
<br>><br>> > At 2006-05-31 09:27 AM -0500, Tegan Dowling is rumored to have said:<br>> >> (:if exists {$Name}-Talk:)There is also a [[{$Name}-Talk |<br>> >> discussion]] page used during the development of this {$Titlespaced}
<br>> >> page.(:ifend:)<br>><br>> Now I'd like to partly contradict myself and say that I'd like to see more<br>> conventions used within PmWiki (and/or <a href="http://pmwiki.org">pmwiki.org</a>). These conventions
<br>> would be there to help things look (and be!) more consistent, making the<br>> site easier to use for casual users.<br>><br>> One convention already in use at <a href="http://pmwiki.org">pmwiki.org</a> is placing something like
<br>><br>> %audience% authors (basic)<br>><br>> at the top of each page to indicate the intended audience. The direct<br>> consequence of this text is that it places a note at the top right side<br>
> indicating the indented reader. This is of course useful for someone<br>> taking a quick look at the page.<br>><br>> An indirect consequence of the convention of placing the above markup on<br>> each such documentation page, also allows us to list all those pages, eg
<br>> <a href="http://pmwiki.org/wiki/Test/ListBasicAudiencePages">http://pmwiki.org/wiki/Test/ListBasicAudiencePages</a><br><br>I like this. Below Christian mentions a second step of putting in a<br>description in each page. I would go one step further and query
<br>whether we should put a (:description:) in every page, and in the page<br>listing he offers have a template that lists the page with its<br>description. That way, a more concise summary would be available in<br>the page list. For descriptions that have a place in the body of the
<br>document, the author should only have to slip in a {$Description} to<br>avoid redundancy.</blockquote><div><br>I'd like some help understanding the use of (:description ...:) - how does this relate to RSS-generation? In the rest of the world, is there a standard name and format for the summary clip that accompanies a link to an RSS article? is that called "description"?
<br></div></div>