Gentoo Wiki:Feedback

From Gentoo Wiki
Jump to:navigation Jump to:search

Got feedback for the wiki overall? You have found the right place to share it!

We're beta-testing a new way to discuss wiki feedback on this page. Please feel free to leave (meta-)feedback about this page as well.

Related Pages

Archived Feedback

CommentStreams are indexed by search engines
Waldo Lemmer|Posted on May 16 at 6:30 pm|

CommentStreams are indexed by search engines. For example, this was the second result when I searched for "gentoo wiki open discussions" on Google.

About the next wiki software update
Waldo Lemmer|Posted on May 15 at 6:29 pm|Last edited on May 24 at 7:20 am|

I am aware that things on this wiki take time, since it's run by volunteers and the staff have busy lives; this shouldn't be seen as an attempt to rush things. With that being said, I do think it's worth mentioning a few currently unmentioned benefits of a wiki software update:

Improvements to <syntaxhighlight>[edit]

The current version of Extension:SyntaxHighlight doesn't have a dedicated language for wikitext. The best we currently have is trac-wiki, which seems to only highlight two things (CommentStreams breaks the highlighting, so I can't show it here):

== Headings ==

[[Wikilinks]]

Newer versions of the extension bring:

A working visual editor[edit]

See Project_Talk:Wiki#Roadmap:_Updating_MediaWiki_will_fix_the_visual_editor.

I know of at least one more thing, but it has slipped my mind. I will update this list as I come across things.

CommentStream sorting in Category:Open discussions
Waldo Lemmer|Posted on Apr 17 at 7:59 am|Last edited on May 5 at 12:55 pm|

Open discussions on this page seem to be stored on pages with hashes for names, such as CommentStreams:6d590a057f848f6ff6ab436b812c58b5.

Their sorting at Category:Open discussions is messed up.

You should probably discourage the use of {{Talk|open}} on this page, but allow discussions to be closed with {{Talk|closed}}.

User:maffblaster|Posted on May 8 at 7:49 pm|

Yes, unfortunately the CommentStreams extension formatted new discussions in that manner. Thanks!

Suggestion for open discussion categories
Waldo Lemmer|Posted on Apr 17 at 7:45 am|Last edited on May 9 at 9:17 pm|
Talk status
This discussion is done.

Project:Wiki#Open_discussion_discovery_improvements

I propose the following subcategories of Category:Open discussions. I've created the categories and the templates; I just need approval to add more pages to them:

Category Viewed by Similar GitHub label Template syntax (! should be a vertical bar)
Open discussions Contributors {{Talk}}
Good first discussions New contributors good first issue {{Talk!good first discussion}}
Discussions needing help Contributors help wanted {{Talk!help wanted}}
Discussions on hold {{Talk!waiting}}
Solved discussions Admins {{Talk!solved}}

Contributors can prioritize new discussions (Open discussions). These discussions should be fixed or moved to another category as soon as they are seen.

New editors have some easy work to do (Good first discussions).

Discussions waiting for admins (Solved discussions) or replies from their authors (Discussions on hold) are kept separate from other discussions, reducing noise.

Open discussions will be more manageable considering Open discussions is currently two and a half pages long.

User:maffblaster|Posted on May 8 at 7:48 pm|Last edited on May 8 at 7:51 pm|

Having a little more structure here is fine by me... and if you want to go through all of them and categorize them I won't stop you.

Implement it! Thanks!

Typo on homepage
Waldo Lemmer|Posted on Apr 8 at 4:54 pm|Last edited on May 9 at 9:16 pm|
Talk status
This discussion is done.

Community member who would like to help with this effort can use those pages as a reference.

User:maffblaster|Posted on May 8 at 7:41 pm|

Fixed.

Some important buttons are hidden on mobile
Waldo Lemmer|Posted on Apr 1 at 5:25 am|Last edited on May 9 at 9:16 pm|
Talk status
This discussion is done.

The buttons to access my profile, edit a page, or view its history are hidden on mobile. I contribute whenever I have free time, but I don't want to whip out my 19" laptop to edit when I'm in the doctor's waiting room or on the toilet.

This issue is also present when using side-by-side windows at 1080p.

I know there are already three different menus at the top on mobile, but maybe you could hide all toolbars behind one button?

User:maffblaster|Posted on May 8 at 7:42 pm|

This is a known issue. See: https://bugs.gentoo.org/575534

Why do we not allow user avatars, and should we?
User:ris|Posted on Nov 27 at 7:34 pm|

I believe we have had a long-standing policy of disallowing user avatars, as stated on the file upload page. I was wondering if anyone knows why this was put in place, and if there is any reason to continue with this rule? I'm about to delete yet another avatar that has recently been uploaded, and to be honest it almost seams a little mean xD.

User:maffblaster|Posted on May 8 at 7:45 pm|

Only reason I can think of, which I can't remember partaking in deciding, is that many images were being uploaded without a license. A lot of the 'avatars' being used were from copyrighted work, and did not fit the license requirements for file uploads.

Personally, I don't really care if you want to upload a picture of yourself and mark it under CC-By-SA 4.0...

Hi, I want to fetch the wiki articles once every two months.
PerlDownloader|Posted on Apr 29 at 8:44 pm|Last edited on Apr 29 at 10:16 pm|

Hi, Wiki Team.

In the context of a network isolation preparation project which will offer a rsync or torrent download for the people interested to have a compilation of essential free software components, I found that the Gentoo wiki may be a very important resource along with the already downloaded Gentoo mirror.

I thought that since scrapping your entire website may raise a few eyebrowns to ask first to iterate over the entire wiki's articles.

I want to limit the scrapper to 5 simultaneous request at a time and I am (if I am granted permission.) going to use the Mojo::UserAgent Perl CPAN library.

The content to be downloaded is the source and name of every single article not in the User: namespace of the wiki, no multimedia content will be downloaded, no images and no video.

I would want first permission to do this and then I would like to ask for guidance to avoid to cause any problem, I read the FAQs about the privacy concerns which will be avoided cleaning any personal data and avoiding the User: namespace, but if any other but exists I would want to hear about it to avoid any problems that may arise.

I will develop the scrapper by myself, I am not going to use any existent tool to do it.

Regards, PerlDownloader.

User:maffblaster|Posted on May 8 at 7:47 pm|

I don't think anyone minds if you scrape the site in a controlled, sensitive manner like the one you proposed. Just don't try to setup a public clone of the wiki while still using the Gentoo name and logo, etc. Thanks for asking!

Deprecate "featured documents" link in documentation menu?
User:ris|Posted on Apr 29 at 8:04 pm|

The "featured documents" link in the documentation menu at the top of pages just links to a virtual-duplicate of that menu on the main page. I think it used to link to a documentation index that we don't have anymore.

It just seems confusing to have that entry now, can we remove it?

Thanks -- Ris (talk) 20:04, 29 April 2023 (UTC)

User:ris|Posted on Oct 1 at 7:08 pm|
FontAwsome icons update
User:ris|Posted on Feb 5 at 6:56 am|Last edited on Feb 5 at 7:00 am|

We were discussing with Jeffery Gazso (JGaz) on IRC about providing an appropriate icon for the {{InfoBox wiki}} template. Hope I'm not misrepresenting things, but I think what came out of it is that there isn't anything really ideal currently available, but updating FontAwsome might provide some better options.

Just to indicate that I have filed a bug #893256 about this. If there is anyone who could help out with updating this, or has more info, could you please get in touch there ?

TIA -- Ris (talk) 06:56, 5 February 2023 (UTC)

Templates not appearing in categories
User:ris|Posted on Aug 18 at 8:59 am|

Some templates do not seem to be getting listed in the categories to which they belong.

{{PortageNavbox}} and {{RootNavbox}} are for example in Category:Navboxes, but that category page has no corresponding members listed at all. {{Archived}} is similarly in Category:Maintenance templates but does not appear there. These categories do appear at the bottom of the template pages. These categories are added to "includeonly" sections of the templates doc page - in just the same way as in templates for which this works, like {{Dated}}.

Am I missing something ? Thanks in advance to anyone that may be able to help.

User:ris|Posted on Mar 31 at 10:34 am|

This seems to work now. Not sure what side of the keyboard the issue was on.

Issue posting certain links to the wiki
User:ris|Posted on Aug 16 at 6:01 am|

I'm having an issue where if I try to save a page containing certain content, the page will not save. Pressing the save button on a page containing the problematic content goes to a blank page, save for the site header and footer, with no error message. The whole content prior to pressing the save button is lost.

I've tried in "private mode" in case it could be a browser configuration issue.

Here are two separate snippets which prevent saving a page: https://dpaste.com/BLHEEMZ34 .

Thanks in advance to anyone who might have a clue as to what is happening.

Waldo Lemmer|Posted on Apr 2 at 4:53 am|Last edited on Apr 2 at 4:53 am|

The link broke :/

Is Would it be Possible to Add Labeled Section Transclusion Support?
JGaz|Posted on Jun 29 at 12:05 am|

I realize I'm new to this wiki and so this is sort of a bold request, but I'm going to ask anyway. I'd really like to see Labeled Section Transclusion support added to Gentoo's wiki. It's a fairly standard wiki extension that enables a lot of very useful features for a project like this one. In a nutshell:

  • Complex documents (like handbooks) could be woven together from smaller labeled sections of unchanged core content plus the deltas for a given architecture or configuration.
  • Sections of package documentation could be reused seamlessly by guides and other articles wherever relevant.
  • Documentation for closely related forks would be easier to deal with.
  • I think I've seen it used as an aid to translation as well, but I'm not 100% sure.

The Labeled Section Transclusion mediawiki extension documentation is here https://www.mediawiki.org/wiki/Extension:Labeled_Section_Transclusion

User:maffblaster|Posted on Aug 4 at 7:52 pm|

I don't see a reason to not include this extension on the next round of updates. I could see it being useful for Handbook development and for other reasons.

Check our project page roadmap to stay informed. Once it's added you'll see it show up under the Special:Version page.

New article doesn't get listed on Recently added pages
Paul Gover|Posted on May 13 at 3:52 pm|Last edited on May 13 at 3:52 pm|

An observation on the (sensible) recommendation to write new wiki articles as User: pages first, and then move them where they belong once they're sorted. It appears that the page is already old when it now appears in its final location, so it doesn't get listed in "Recently added pages", nor on "Fresh documentation" on the Gentoo home page. At least, that's my assumption; my latest magnum opus was missed (not complaining, just pointing out that the system may not work how people might be assuming.)

(Copied from the Gentoo forums, where I first posted this.)

Grknight|Posted on May 13 at 5:26 pm|

This is primarily a limitation of how MediaWiki works. Both of the mentioned data sources query from Special:NewPages. I don't believe that Moved articles are considered there. The best way for articles to be found is to link them and categorize them.

Dark theme (read property of useragent prefers-color-scheme)
Vitaly Zdanevich|Posted on Jul 9 at 5:56 pm|Last edited on Nov 1 at 7:47 pm (moderated)|
Talk status
This discussion is done as of November 1, 2020.

Hi, dark theme is important for many users because of sensitive eyes, working in a low light condition, and for battery saving. All modern browsers support this property https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme

Even without JavaScript, in pure CSS, you can override some CSS variable if user prefer it.

Grknight|Posted on Jul 9 at 8:07 pm|

See also bug #676616

User:maffblaster|Posted on Nov 1 at 7:17 pm|

How about simply use a browser extension? Something such as: https://addons.mozilla.org/en-US/firefox/addon/darkreader/

Same thing exists for Chrome: https://chrome.google.com/webstore/detail/dark-reader/eimadpbcbfnmbkopoojfekhnkhdbieeh

If you're using Edge or I.E. then there is no helping you. :P

User:maffblaster|Posted on Nov 1 at 7:45 pm|

Looks like this is something arzano may look at in the future. We'll be closing this discussion and tracking on our official bug tracker.

Interested parties can updates here: https://bugs.gentoo.org/676616

Translator account requests page doesn't seem to be updated for a long time
Soymilk|Posted on Jun 26 at 1:14 pm|Last edited on Nov 1 at 7:47 pm (moderated)|
Talk status
This discussion is done as of November 1, 2020.

some translations are outdated.

User:maffblaster|Posted on Nov 1 at 7:46 pm|

Wiki project is currently not finding the time to mark various articles for translation. I'll try to get to some today.

Automated sync from untranslated to en article
Vaukai|Posted on Mar 24 at 12:22 pm|Last edited on Nov 1 at 8:03 pm (moderated)|
Talk status
This discussion is done as of March 24, 2020.

Original language - even for untranslated articles - is English. Translated articles - even the English ( /en ) versions - are updated only after mark for translation. Is there no way to autosync the /en with the basic versions?

Example:

Grknight|Posted on Mar 24 at 4:00 pm|

No, this is a function of the Translation addon when marked for translation. Messing with it is likely to break translations.

Non-functioning statements on https://wiki.gentoo.org/wiki/Handbook:AMD64/Full/Installation/de
Mike|Posted on Oct 29 at 2:23 am|Last edited on Nov 1 at 8:02 pm (moderated)|
Talk status
This discussion is done as of October 29, 2020.

The page contains non-functioning statements for handling and installation of stage3 tarballs.

Example:

 English version (correct): tar xpvf stage3-*.tar.bz2 --xattrs-include='*.*' --numeric-owner
 German version: tar xvjpf stage3-*.tar.bz2

The German version won't work at all, because option 'j' makes tar to work only with bzip archives. But current stage3 tarballs are 'xz' archives.

I tried to change the statements on the german Wiki page, but I can't. Which rights do I need? Translator permission? Or does 'translator permission' work only for text, but not for code?

Grknight|Posted on Oct 29 at 12:44 pm|

I've updated the command but not the comment that went with it (since I don't speak German). Unfortunately, a good portion of the Handbook is far behind in translation in German. Those that wish to help, need to read Help:Translating then sign up at Gentoo Wiki:Translator account requests

Mike|Posted on Oct 29 at 4:37 pm|

Thanks! I just added myself to the 'Translator account requests' page.

User:maffblaster|Posted on Nov 6 at 12:42 am|Last edited on Nov 6 at 12:42 am|

Thanks, Mike! It's best just to use the auto detection with tar in order for that command to work in any situation.

I'll be doing some documentation updates over the next few days. Perhaps I'll record/stream some of it as well so that others can get more comfortable working with our wiki.

The "Recent changes" page
GuillermoDH|Posted on Sep 20 at 11:13 pm|Last edited on Nov 1 at 8:02 pm (moderated)|
Talk status
This discussion is done as of November 1, 2020.

Has anyone noticed that, since a couple of days ago, the Special:RecentChanges does not actually show all changes? For some reason it misses some. Article revision history pages and user contribution pages seem to be complete.

User:maffblaster|Posted on Nov 1 at 8:01 pm|

I believe this should be resolved now. Please let us know if you continue to experience issues viewing recent changes.

What's the right way to deal with spam on here?
Anonymous|Posted on Sep 15 at 5:19 pm|Last edited on Feb 15 at 5:30 pm (moderated)|
Talk status
This discussion is done as of 2022-02-15.

On the forums we have a report button. I've noticed a massive number of sockpuppet accounts being created in the last few weeks (https://wiki.gentoo.org/index.php?title=Special%3ALog&type=newusers) and some of them are starting to show activity.

Grknight|Posted on Sep 16 at 12:09 am|

The trick is how to separate real uses from bots. We do have a captcha which often needs some Gentoo knowledge. Might be time to rotate those.. but have to figure out what to.

Anonymous|Posted on Sep 16 at 12:24 am|

Maybe reuse some existing Q&A from solved threads in the forums? :)

If spammers are getting past the current one it's likely they've automated responses to it, the questions look fairly trivial to parse.

User:xxc3nsoredxx|Posted on Feb 25 at 7:49 am|

What about just reverting any changes you come across that look suspicious? Since, AFAIK, there isn't a "report user" feature on here.

User:maffblaster|Posted on Feb 15 at 5:30 pm|

We (the developers) watch the changelog almost everyday. If we notice anything that look malicious we revert the changes and may choose to immediately ban the account. I would be in support of a better captcha or spam limiting system if we notice things getting out of hand.. that's a bridge that can be crossed if/when it is needed. I'll put it on the Project:Wiki's todo list backlog. Since I've been with the Gentoo wiki, we have very rarely seen malicious users. Our community is pretty awesome, I guess. =)

If you do notice an edit that looks malicious, then the edit can be undone. Accounts that are clearly spammers will be swiftly banned.

I think it's fair to be able to close this discussion for now, since the original question was answered. Reopen if it is necessary. Thank you!

gentoo-wiki.com is gone
Garbanzo|Posted on Aug 17 at 5:58 am|Last edited on Nov 1 at 7:41 pm (moderated)|
Talk status
This discussion is done as of August 17, 2020.

Minor, but 'gentoo-wiki.com' doesn't seem to exist anymore but is shown whenever a page is edited. It is just the stock godaddy parked page. Remove it from the notice?

Do not submit copyrighted work without permission! • Do not copy articles from other Wikis (including gentoo-wiki.com)!

Grknight|Posted on Aug 20 at 12:52 pm|

I've changed the wording to say "(including other unofficial Gentoo Wikis)" this makes it more generic. if others appear later, or from the Way Back Machine, we don't have to keep modifying.

Feedbacks about translations
Anonymous|Posted on Jun 13 at 6:20 am|Last edited on Nov 1 at 8:00 pm (moderated)|
Talk status
This discussion is done as of June 13, 2020.

You are welcome to share your ideas about wiki translation.

User:maffblaster|Posted on Nov 1 at 8:00 pm|

Thanks.

Christmas
User:fturco|Posted on Apr 9 at 9:25 pm|Last edited on Nov 1 at 8:00 pm (moderated)|
Talk status
This discussion is done as of April 10, 2020.

On the Gentoo Wiki main page there's a link to a random YouTube videos with the following description: "Christmas is coming a little early this year for the wiki!". Can we remove it please? There's plenty of Gentoo users who don't celebrate or don't like Christmas, for many reasons. Religious holidays are off-topic on this wiki.

Grknight|Posted on Apr 10 at 1:35 pm|

I've reworded the announcement to be less offensive to a wider audience

User:fturco|Posted on Apr 10 at 6:54 pm|

Thank you!

User:maffblaster|Posted on Nov 1 at 7:59 pm|

I'm fully unapologetic about the Christmas news announcement. It's a Federally recognized national holiday here in the U.S. and the birth of Christ is celebrated in every country around the world. Nothing wrong with mentioning a holiday where people give other people gifts (in this instanced reference I was referring to the developers who maintain the wiki this was the motivation behind "Christmas coming a little early this year" comment).

It seems sensible to not be offended by others celebrating a holiday.

No permission for feedback
Garbanzo|Posted on Apr 2 at 5:56 am|Last edited on Nov 1 at 7:49 pm (moderated)|
Talk status
This discussion is done as of April 2, 2020.

So the first time I tried this it said I needed to log in first and wouldn't take my comment. It worked after editing (and canceling) the Dissussion page, not sure why.

User:maffblaster|Posted on Nov 1 at 8:03 pm|

Thanks for the heads up.

Links from packages pages
Garbanzo|Posted on Apr 2 at 5:50 am|Last edited on Nov 1 at 7:49 pm (moderated)|
Talk status
This discussion is done as of August 8, 2020.

It would be nice to have links to relavent wiki pages from the packages.gentoo.org pages. It would make it easier to navagate around.

Grknight|Posted on Apr 2 at 1:10 pm|

This is not an easy thing to do. packages.g.o is a purely metadata generated site from the ebuild data. It has no cross linking capabilities written into it.

Garbanzo|Posted on Apr 3 at 3:33 am|

Maybe packages.g.o could link to a generated name like wiki/autoPackagesLink_PackageName if it exists. Then wiki editors could create redirect pages to point to the right place.

User:maffblaster|Posted on Jun 24 at 10:19 pm|

This would be a lot of extra overhead, as ebuilds tend to be renamed, merged, removed, etc. If there was an easier way to get this functionality working it would be more supportable.

Garbanzo|Posted on Aug 5 at 5:52 am|

It looks like this can already be done from the ebuild. https://packages.gentoo.org/packages/app-editors/nano has links to both the nano home page and the gentoo wiki. both urls are in the ebuild.

Grknight|Posted on Aug 6 at 2:56 pm|

Doing so would be up to the maintainer of the package and has nothing to do with the wiki itself. This is one case where it is a rarity and unlikely to be adopted by the masses.

User:maffblaster|Posted on Aug 8 at 4:36 pm|

I agree with Grknight... Unless we add another optional variable in a Future EAPI update for the ebuild itself to include a a link to the package's relevant wiki page. =)

For now the best way to is to actually search the wiki for the package itself, which is exactly what the link on packages.g.o does when you click the "Documentation" link.