Gentoo Wiki:Suggestions/Archive

Feel free to add suggestions for our Wiki on this page. Remember to sign your suggestion with, or the "Signature and timestamp" button in the editor toolbar.

Open
Relationship with existing Gentoo documentation
 * Will it be possible to somehow incorporate the existing Gentoo documentation into this wiki, perhaps have this as the user editable version, with revisions pushed to the guidexml docs with are the official "reference" and are verified to be of a certain quality by the documentation team. --Mark alec 13:53, 26 September 2011 (UTC)

Via email: When trying to use a RootCmd or  environment within a numbered list, the list counter gets reset to 1. Thus I ended up using bullet lists.

A button to (un)fold large code and file template blocks, to maintain readability. Hypnos 04:45, 28 September 2011 (UTC)
 * There will be a built-in solution in MediaWiki 1.18, see http://www.mediawiki.org/wiki/MediaWiki_1.18#New_plugin_for_collapsible_elements --Astaecker 15:37, 6 October 2011 (UTC)

Templates to link to external docs like Wikipedia or Gentoo documentation, see my user page. --Astaecker 13:14, 7 October 2011 (UTC)

Done
Relationship with existing Gentoo Wikis
 * Duplicating effort and spreading documentation across more sites isn't beneficial, just increases the likelihood that things will rot or misinformation will be found. If the infrastructure for this site is good, I'd like to see the existing wikis folded into this slowly, with editting and culling as required. This may be difficult based on licenses --Mark alec 13:53, 26 September 2011 (UTC)
 * See Gentoo Wiki:Meetings/2011-10-17, topic 2. Astaecker 07:49, 18 October 2011 (UTC)

Categories for several things like templates, hardware, software etc. Disi 07:14, 26 September 2011 (UTC)
 * See Gentoo Wiki:Meetings/2011-10-17, topic 4. Astaecker 07:49, 18 October 2011 (UTC)

Is there already some kind of policy decided? --Astaecker 08:19, 26 September 2011 (UTC)
 * Internationalization (i18n):
 * As the "translate" extension is installed, I guess you decided on the "top (english) -> down (other languages)" approach.
 * How should the i18n-sites be named?
 * subpages: SITENAME/de / SITENAME/Deutsch
 * Translate extension's method
 * Astaecker vote
 * See Gentoo Wiki:Meetings/2011-10-17, topic 5. Astaecker 07:49, 18 October 2011 (UTC)
 * regular pages with i18n extension: SITENAME (de) / SITENAME (Deutsch)
 * Where to position the i18n-links? Goal: i18n-readers want to read the page in their language. --Astaecker 10:29, 26 September 2011 (UTC)
 * sidebar: unused space, non-distractive for english readers, but not-easy-to-spot for i18n-readers; Wikipedia's solution
 * top: easy-to-spot for i18n-readers, but distractive for english readers;
 * Astaecker vote
 * bottom: non-distractive for english readers, but not-easy-to-spot for i18n-readers
 * Use of Special:MyLanguage for internal links? --Astaecker 12:36, 30 September 2011 (UTC)
 * template to easy writing internal links.
 * Navigation: (the sidebar and the main page should be enhanced)
 * by categories
 * Astaecker vote. For example "main page" see http://de.gentoo-wiki.com/wiki/Hauptseite
 * : See Gentoo Wiki:Meetings/2011-10-17, topic 4. Astaecker 07:49, 18 October 2011 (UTC)
 * by index pages

How about copying Mediawiki's Users Guide here. This guide is intended to be copied to new wikis, see Mediawikiwiki:Project:PD help. We are already linking to parts of it in our help pages. --Astaecker 07:34, 27 September 2011 (UTC)
 * See Gentoo Wiki:Meetings/2011-10-17, topic 6. Astaecker 07:49, 18 October 2011 (UTC)

Kernel configuration template
 * done Template:Kernel --A3li 09:53, 22 September 2011 (UTC)

RSS/Atom extension: To follow the ongoing expansion, please install the RSS extension.
 * A bot reports all changes to the irc channel. As i'm not so much an irc user, I still hope for a rss extension. --Astaecker 09:56, 26 September 2011 (UTC)
 * Reading its description page, it displays an RSS feed. How would you use that to track progress?
 * With RSS I don't have to check "Recent changes" myself, KDE Akregator (or whatever) is doing it for me. --Astaecker 11:20, 26 September 2011 (UTC)
 * There's an atom feed already available: http://wiki.gentoo.org/index.php?title=Special:RecentChanges&feed=atom Can you use that? --A3li 11:25, 26 September 2011 (UTC)
 * Ha, didn't know, Mediawiki has a default atom feed. Nice. Done. --Astaecker 11:28, 26 September 2011 (UTC)

Enhanced preformatted template for code blocks
 * done Template:File and Template:Code --A3li 09:53, 22 September 2011 (UTC)
 * How about a syntax hightlighting enhanced File template ? See this for an example. For this, we need the SyntaxHighlight GeSHi extension. --Astaecker 07:48, 26 September 2011 (UTC)
 * More than one line for the RootCmd and Cmd? Disi 09:41, 26 September 2011 (UTC)
 * should work --A3li 10:36, 26 September 2011 (UTC)
 * hey, that works but the line spacing goes weird in the last line, I saw Astaecker set up some custom Cmd for more than one command, is that going to become available? Disi 07:11, 29 September 2011 (UTC)
 * Done --Astaecker 12:48, 29 September 2011 (UTC)
 * could you include a  tag for the commands, codes and shells? Disi 08:48, 26 September 2011 (UTC)
 * That would disable any formatting people could make to highlight certain parts in the code. Not sure we want this --A3li 10:36, 26 September 2011 (UTC)
 * Template for stdout/stderror terminal messages --Hwoarang 10:10, 26 September 2011 (UTC)
 * use Template:GenericCmd --A3li 10:36, 26 September 2011 (UTC)

Notes template, and probably different templates for each type ( warning, important, information ) like those we have in gorg-xml
 * done? Template:Note and Template:Warning are available --A3li 10:35, 25 September 2011 (UTC)
 * any way to increase the padding around the template environments, especially below them? Using them makes a page look rather busy (for example). --Hypnos 06:00, 26 September 2011 (UTC)
 * Spacing should be the same as for one regular paragraph now. --A3li 12:53, 29 September 2011 (UTC)

How about a "how to configure the kernel" link in kernel template caption bar? Also a "how to edit a file" link in the file template caption bar? --Astaecker 09:17, 26 September 2011 (UTC)
 * The new content boxes can display additional links. I've added a sample link to Template:Kernel. Not sure if we need that for editing files, I expect people to know that. Maybe link to a Category:Editors if we have something like that one day. --A3li 12:50, 29 September 2011 (UTC)
 * Nice. We should do it even for File and link to nano, because this is at the moment the default editor. This will be good for newbies. Pros will never click on the link. --Astaecker 12:57, 29 September 2011 (UTC)

Unlock templates. As long as the beta wiki is password protected, please unlock the templates, so everybody can enhanced the templates. The fear of abuse is in this phase IMO counterproductive. I, for example, wanted to write some template documentation. --Astaecker 09:24, 26 September 2011 (UTC)
 * for the time being unlocked. just don't break them. Oh, and if you want to use the standard transcluding mediawiki template doc stuff, please don't use that ugly "i" icon. ;) --A3li 10:36, 26 September 2011 (UTC)