Old Business: - Done! | |
Renovate home page | |
See next home page DT: Home page was just cleaned up by ricks99. Please post a specific proposal to the dev list. DT: xavi helped get items postitioned on the page, let's make sure all links work and install it MLP:Looks good! Latest version at http://zukakakina.com/tiki-switch_theme.php?theme=mittwoch.css. See Coffeeshop post. |
Discontinue Right Column | |
Motion: Discontinue the right column. Keep the Left column. Use phplayers menu for top bar login DT: This was proposed by franck in IRC. I like the idea of having more screen real estate. Please review the next motion as well. in favor: xavi, MLP, sylvieg, chibaguy, ricks99 |
New Business | |
Naming conventions for features. | |
Motion To add to our Naming conventions a rule about feature names, and make it universal on doc.tiki.org, dev.tiki.org and tikiwiki.org, it is important to have a common way of naming features. So we always know that doc:Newsreader is it does and dev:Newsreader is what we wish it did.
Options: ML: I can live with any choice as long as we are consistent. Keywords page seems the way to go 😊 Let's decide on a masterlist and after, we clean up all the help links from the software itself and from other *.tiki.org sites... Motion: Naming Rules for Features
Marc: I renamed all the pages. I hope it's OK with everyone. MLP: Ok "prefer the singluar" dropped in favor of a more natural approach. chibaguy (after reading Skype log discussion of singular vs. plural for page names): [soapbox mode on] I think "natural speech" vs. "search term" isn't the best way to approach this question. People doing searches generally enter the singular form because it's the most common, most-root form and thus most likely to return good results. But there is a different rationale for page names. What is the logic for, for example, a page named "Comment" that has a title (h1 headline at page top) of "Comments"? This inconsistency shows there is something wrong with the page name, which doesn't correctly label the page content. If the page defines (the concept or whatever of) "comment," as in a glossary, then singular is appropriate. But the doc pages here are more comprehensive than that, and the plural form is often more suitable. This is the logic as I see it: reflect in the page name the use of the term in the Tiki context. People may search for "smiley" but they don't think "How do I use smiley?" An index will contain "smiley", but it will often refer to a page called "Smileys" or "Using Smileys" or whatever. That's the nature of that connection. Keywords can still be (and generally should be) singular, but they can link to pages named with either the singular or plural form (or a multi-word term if that's appropriate). It's counterproductive to streamline for simplicity's sake if comprehensibility is reduced in the process. When I see singular forms of words where I (as a user of the language) expect them to be plural, it strikes me as taking a principle too far. The impression is skeletal output that needs a commonsense touch to make it (in this case) good English. [soapbox mode off] |
Current features for renaming | |
Footnotes ---> "My Notes" (in favour: ) or "Private Notes" (in favour: Xavi, chibaguy) note we gotta harmonize it across atleast two, doc and dev. |
Batch creation from structures | |
Motion No more batch creation of page in 6 languages from structures + let's erase all non English pages which have no content. Sylvie is looking into a batch delete of all pages which have no content. ML: Let's be realistic! Let's get things going properly in English and the other languages will evolve organically. MLP: Oui! |
Clarify role doc.two vs dev.tw.o | |
(you can wiki the motion, eh.) Motion
|
tw.o: | |
|
doc.two | |
|
dev.tw.o | |
|
themes.tw.o, | |
|
workflow.tw.o | |
mobile.tw.o | |
|
mods.two | |
|
i18n.tw.o | |
Future project to ease translations |
Multilingual development | |
Do we encourage documentation in French to go on doc.tw.o or fr.tiki.org? MLP: Use multilanguage features as they are now? |
feature_autolinks enabled | |
ML: it seems like a good feature. Anyone object? If so, we can turn off, |
Organic growth | |
Motion Let's create at least of page per Keyword and have Tiki helps links to there, but let's wait for a need to create Feature Admin, Feature Setting, Feature Ref, etc ML: Features are so different. Some need one page, some need 5-6. Better to start with one page and refactor as needed. But the goal is to still have a structure and ultimately use WebHelp to make offline copies and print from structures to PDF to make a manual at least as great as the Tiki 1.6 docs. Xavi: However, I like the basic common structure for all pages (Feature User, Feature Admin, Feature Details). I would suggest to keep it as it is, and and new pages when and where needed. But for new documenters, that basic division in three basic pages per feature allow organizaing content, etc. MLP: About the Tikiwiki documentation - updated. Idea: have a nice quicktag for voting, which adds these nice icons: |
Underline h2 and h3 headers in default css for Tikiwiki sites | |
Motion For instance, what I'm using in many places (see demo at http://www.moviments.net/drecerca/Ajuda ) Copy to clipboard
Line type options:
Line Colour
Xavi: I suggest the example in the box below: dashed grey for h2, dashed light-grey for h3. no line for h1. |
Discontinue tracker8 here at doc.tw.o (doc. bug report through trackers) | |
Motion Discontinue tracker8 here at doc.tw.o. Use Author Coffeshop forum instead, either through the "discuss" button of the related page, or directly as a new thread. If motion is accepted, link from http://dev.tiki.org/Documentation to http://doc.tiki.org/tiki-view_tracker.php?trackerId=8 ("Doc Bugs & Wishlist") should be removed, and write Author Coffeeshop forum instead. Next meeting: July 2007 |