Editorial Board Meeting 2008 08 | |
NEW CONTRIBUTORS: Please Read
This is a meeting of the Editorial Board - it runs online from August 1 to August 31.
{MAKETOCBOX(float=>right)}{MAKETOCBOX} |
Motions Passed Last Month | |
|
Motions Defeated Last Month | |
none |
1. Motions Carried Over | |
|
1.1. Screenshot Tagging/Captioning | |
Motion: Tag or identify with a caption the version of Tiki each screenshot is from with the goal of the screenshots matching either the current release, or the current release candidate, whichever is more imminent. In the case of today, we would try and get all screenshots current as of 1.10.0 until we come up with a 1.10.1 down the road. The Change Log proposed above will fill in the blanks. Maybe also have a "-HEAD" version of the page that talks about and documents changes to an existing feature that are in development in the head branch. When the time comes, those details can be easily incorporated into the current release page. Obviously, if the feature doesn't exist yet, then instead of having a -HEAD version (for example Contributions-HEAD), then it'll just be the name of the feature (Contributions) and in the Change Log section we'd have "1.11.0 - Introduced". I think we need to document new features that are being developed, but keep it separate from what is current so as to avoid confusion. Discussion:
Opposed: chibaguy (opposed to specific version numbers on screenshots unless the image is for a beta or old release), luci (can be described under the image)
|
1.2. New Chief Editor | |
Motion: That candidates for editor in chief be nominated (or nominate themselves) by editing the page: Chief Editor, and that the nomination process simply entails improving (on that page) the definition, responsibilities and priorities for someone in that role.
Dave Thacker has been a great chief editor. He wants to step down gracefully and we are hard pressed to honorably refuse. ð
This is to let the Docs Editorial Board know that they should pick a new Editor in Chief next month, and that person should plan on taking over June''
Vote
In Favor: MatWho Abstain: MLP (defers to the majority view), ricks99 (anyone but me!) Xavi: yes, still opposed, at least for the time being and according to our natural evolution in the last year 2007-2008 |
1.3. Allow Tiki community members to be added to DocContributors | |
Motion: Allow registered users to be added to DocContributors, after they confirm they have joined the TikiWiki Community Group. See http://tikiwiki.org/tracker8
MLP: doesn't understand what this is about. ð
Opposed: ricks99 (if i understand correctly....) |
1.4. Dogfood versions plugin | |
Motion: To use PluginVersions as seen in Manual Installation to distinguish 1.9.x vs 2.x docs
In Favor: marclaporte, xavi, luci, ricks99 Opposed: mlp (prepared to live with the shadowy world of gradual updates and casual references to version.)
|
2. New Motions | |
2.2. Revision of left hand menu | |
Motion: I propose that the left hand column 'Documentation' menu should simply contain the main content headings used in the documentation page - Introduction, Installation, Configuration, etc.
MLP: I think the LH menu should use a wiki page - like the main LH menu in dev.tw.o
MLP: (point of order) Mat - i think new members votes count - the Editorial Board page should contain the complete set of rules (or a link to) - and it is a very short set.
Opposed:
|
2.3. Re-structure section introductions | |
Motion: That the main documentation adopts a strict tree structure, so that section introductions are not hidden dead ends.
Alternatively a user might choose the main heading 'Introduction', and be unaware that he has not covered the whole of the 'Introduction' section (as there are indeed mini-subheadings within that little branch). I suggest there should be 4 sub-headings - clicking on the 'Introduction' heading should take the user to a page which simply lists the 4 sub-headings. That is what would be expected by very many users. In Favor: Opposed: |
2.4. Revision of Author Resources menu | |
Motion: Remove the 'CoffeeShop forum' item from the Author Resources menu.
I recall the decision to end the coffeeshop discussion, but am not sure what was proposed to replace it. Maybe this is in the past board meeting notes, which I haven't read recently ð¡ (chibaguy). klang: xavi pointed me here - that's why I've arrived ð. Not sure whether this is a good place for discussions though - or whether I should be discussing via proposals... feel free to point me on a better path In Favor: Opposed: |
2.5. New Motion - For September | |
Motion: That the Editorial Board adopts, as the terms of reference for itself the contents of the page Editorial Board as of sept 30 2008.
Opposed:
|