VoteOnSiteHeader
The thread at [1] proposes the addition of some sort of "site-wide header" to the PmWiki default, analogous to the existing Group Headers capability. There are several ways we can approach this, which are summarized in the mailing list thread and options presented below.
Use this page to cast your opinion. Ideally put your name and vote weight for each option you have an opinion on; for example, "Pm +1" means Pm likes an option, "Pm -1" means Pm dislikes an option, "Pm +2" and "Pm -2" indicate a strong like or dislike, and "Pm 0" is a neutral vote. It's okay to leave short (one sentence) comments on each proposal, but please keep them short. Longer comments can go on the VoteOnSiteHeader-Talk page, or the mailing list.
Feel free to add or offer other options if you have them. If they're wildly different from what Pm has outlined, consider describing them in detail on another page.
To make things easier we refer only to headers and GroupHeaders? here, with the understanding that we're also talking about analogous changes for footers and GroupFooters?.
Proposal 1 -- "fallback" group header
In this proposal, there would be a Site.GroupHeader? or Site.DefaultGroupHeader? page that would be used when a group doesn't have its own GroupHeader page. The (:nogroupheader:) directive would prevent any header text from being automatically prepended to the page's markup. A group that wanted to include both its own text and the site-wide header text would use something like (:include Site.DefaultGroupHeader basepage={*$FullName}:).
Option 1a - fallback group header as Site.DefaultGroupHeader?
Votes:
- Petko +2 (very easy to implement, same behavior as our current sidebars)
- cda +2
- jhc +2
- CarlosAB -1
- Simon +2 (see possibility 3 below)
- Kathryn Andersen +2 (complies with the Principle of Least Surprise)
- Hagan +1 but it violates the Principle of Least Surprise when the default header content mysteriously vanishes.
- ScottConnard +2
- Roman +1
- Martin Fick 0
Option 1b - fallback group header as Site.GroupHeader?
Votes:
- Petko -2 (one may want a regular behaving Group header in Site.*, now that this group cannot have it's own sidebar)
- cda -1
- jhc -2
- CarlosAB -1
- Simon -1 (see possibility 3 below)
- Kathryn Andersen -2 (Site may need its own GroupHeader)
- Hagan -2 -- Site's header and
$SiteGroup's header should be separate. - ScottConnard -2
- Roman -2
- Martin Fick +1 Closer to Site.SideBar functionality
Proposal 2 -- site-wide header added to every page
In this proposal, a page in the Site group would have its text automatically added to every page on the site, regardless of the existence of a per-group GroupHeader. For this proposal, we need to decide if the site-wide header should be affected by (:nogroupheader:) or have its own (:nositeheader:) directive, and what to name the sitewide page.
Option 2a - sitewide header affected by (:nogroupheader:), page is named Site.AllGroupHeader?
Votes:
- Petko +1
- cda -1
- jhc -2 see Option 2c
- CarlosAB -1
- Simon -1 (see possibility 3 below)
- Kathryn Andersen -1
- Hagan -1 -- Site-wide and group-wide headers should be controllable separately. (see note)
- ScottConnard -1
- Roman -1
- Martin Fick +1 Nice, but not as nice as 2b
Option 2b - sitewide header has its own (:nositeheader:) directive, page is named Site.SiteHeader?
Votes:
- Petko -1 (as per [2])
- cda -1
- jhc -1 I prefer Site.AllGroupHeader?
- CarlosAB -1
- Simon +2 (see possibility 3 below)
- Kathryn Andersen -1
- Hagan +2 -- I like the concept. The names aren't important to me but
(:nositewideheader:)would be better. - ScottConnard +2
- Roman +2
- Martin Fick +2 Seems like the cleanest names and the most valuable addition
Option 2c - sitewide header has its own (:noallgroupheader:) directive, page is named Site.AllGroupHeader?
The (:noallgroupheader:) directive suppresses only the Site.AllGroupHeader? display.
The page is named Site.AllGroupHeader? & the only group header affected by (:nogroupheader:), page is named *.GroupHeader
Votes:
- jhc +2
- CarlosAB -1
- Simon 0 (see possibility 3 below)
- Kathryn Andersen +1
- Hagan +2 -- I like the concept, but
(:noallgroupheader:)? Imagine seeing that for the first time. (see note) - ScottConnard +0
- Martin Fick +1 2b naming is better
Option 2d - Sitewide header doesn't have a (:nositeheader:) directive, page is named SiteAdmin.SiteHeader?.
votes:
- CarlosAB +2 - SiteHeader? should be used only by admins and
(:nositeheader:)shouldn't be allowed. (moved the rest of my comment to the talk page) - Kathryn Andersen -2 I don't like the idea of nositeheader not being allowed.
- Hagan -1 -- Potentially useful, but as a recipe
- ScottConnard +1
- Martin Fick -2 better left as a customization
- Simon use of
(:nositeheader:)could be enabled in config file
Possibility 3
Is there any reason why there should not be a Site.DefaultGroupHeader? (1a) (similar to Site.SideBar) and Site.AllGroupHeader? (2c)? That way both camps don't have to choose, and we get the best of both worlds
- Simon +2
- Kathryn Andersen +2
- Hagan +0 -- Potentially confusing (too may permutations); creeping featurism -- should be a recipe.
- ScottConnard +2
- Martin Fick +1 Both option 1b & 2b seem very useful