The first video in the TASBot Re: (TASBot Revisited) series is out! TASBot Re: Gradius covers our first run from AGDQ 2014.

Historians wanted: Inquire here.

TASBot Wiki:Village pump: Difference between revisions

From TASBot Wiki
m (Add link to Special:UnusedCategories)
mNo edit summary
 
(20 intermediate revisions by the same user not shown)
Line 5: Line 5:
Categories are arguably a direct upgrade to articles in that pages can have multiple parent categories, and categories have a nice UI for navigating to subpages. The longer URI is why you shouldn't just use them for everything.
Categories are arguably a direct upgrade to articles in that pages can have multiple parent categories, and categories have a nice UI for navigating to subpages. The longer URI is why you shouldn't just use them for everything.


Embrace hypertext—link to other pages (and also other sites, such as <code><nowiki>[[wikipedia:]]</nowiki></code> and {{t|TASVideos}}), but do also follow Wikipedia's linking guidelines: only link first mention, avoid adjacent links, don't over-link common concepts/entities ([[TASBot]], in our case).
'''All editing help and guidelines will be in [[Project:Style_guide|the style guide]].'''


Use redirect shorthands wherever you feel they fit, with one exception: tagging pages with a category '''will not work''' if you use a redirect.
If you need to grep in wikitext, use {{plainlinks|1=/api.php?action=query&list=search&srsearch=querytext&srnamespace=*&srwhat=text&format=json|2=this}} (change <code>srsearch=querytext</code>).


On that note, when tagging pages for appearances with categories, put the year category first, then the event category if it exists (or will later i.e. a redlink).
For those of us used to Git, it can be a bit confusing to look at contribution logs because ''page moves/renames are applied retroactively''.
{{t|infobox appearance}} handles this for you.
 
Familiarise yourself with what templates exist: [[:Category:General-use_inline_templates|inline/formatting ones]], [[:Category:General-use_block_templates|ones for infoboxes and other tables]], {{plainlinks|1=/wiki/Special:AllPages?from=&to=&namespace=10|2=complete list}}.
Hit up [[User:YoshiRulz]] if you want help making new ones.
* To get the visual editor to generate nice code, ensure any block templates you create have <code><nowiki>"format": "{{_|_=_}}\n"</nowiki></code> (as <code>inline</code> but with trailing newline) or <code><nowiki>"format": "{{_\n|_=_\n}}\n"</nowiki></code> (improved version of <code>block</code>) in the TemplateData&mdash;see [[mw:Help:TemplateData#Custom_formats|docs]]. This is unfortunately necessary to do on each individual template since [https://phabricator.wikimedia.org/T205438 the named aliases are hardcoded].
** Getting the generated invocation to not be in sentence case is a lost cause. It seems to honour what was entered manually though.
* <del>When different kinds of block templates are used at the top of a page, follow this order (copied from [[mw:Recommendations_for_mobile_friendly_articles_on_Wikimedia_wikis#Use_consistent_ordering_for_hatnotes,_ambox_and_infobox_templates|here]]): hatnote, ambox, infobox.</del> nevermind that looks ugly (maybe only because amboxen are so big)
 
For consistency (TODO move this to a style guide page):
* Where an event's name has a short form, the expanded form is the canonical one e.g. [[Summer Games Done Quick 2016]], with e.g. [[SGDQ 2016]] being a redirect to it.
** For ESA, short names follow [https://esamarathon.com/history-of-esa-events/ this] (<code>ESA YYYY</code> through 2017, <code>ESA {Summer,Winter} YYYY</code> from 2018).
** For Super MAGFest, have both <code>MAGFest YYYY</code> and <code>magFAST YYYY</code> as redirects (don't bother with <code>DISPLAYTITLE</code>, it doesn't work), ''regardless'' of whether there was TAS content in both a talk and the marathon, or just one.
** <code>LI Retro YYYY</code> is the short name for that.
** <code>BSG Annual YYYY</code> is the short name for that.
** AGDQ/SGDQ/GDQx and LTX are trivial.
** May Contain Hackers ([[:Category:Galactic_Hacker_Party|Galactic Hacker Party]]'s 2022 incarnation) was special-cased and has been given 2 redirects.
** No other events need abbreviating at present.
* Event categories should also be expanded, with redirects ''in the main namespace only'' and following the above rules.
 
If you need to grep in wikitext, use {{plainlinks|1=/api.php?action=query&list=search&srsearch=querytext&srnamespace=*&srwhat=text&format=json|2=this}} (change <code>srsearch=querytext</code>).


The banners at the top of the site are [[MediaWiki:Sitenotice]] (for everyone) and [[MediaWiki:Anonnotice]] (extra banner for everyone who's not logged in).
The banners at the top of the site are [[MediaWiki:Sitenotice]] (for everyone) and [[MediaWiki:Anonnotice]] (extra banner for everyone who's not logged in).
Line 44: Line 24:
* if [[mw:Help:Cite#Separating_references_from_text|semantic citation markup]] is desired (and I believe it is), [[mw:Extension:Cite]] needs to be <del>installed</del> enabled --yoshi
* if [[mw:Help:Cite#Separating_references_from_text|semantic citation markup]] is desired (and I believe it is), [[mw:Extension:Cite]] needs to be <del>installed</del> enabled --yoshi
* current [[MediaWiki:Sitenotice]] is fairly unintrusive, but should we want to make it bigger in the future it should probably be dismissable&mdash;that requires [[mw:Extension:DismissableSiteNotice]] w/ <code>$wgDismissableSiteNoticeForAnons = true</code>
* current [[MediaWiki:Sitenotice]] is fairly unintrusive, but should we want to make it bigger in the future it should probably be dismissable&mdash;that requires [[mw:Extension:DismissableSiteNotice]] w/ <code>$wgDismissableSiteNoticeForAnons = true</code>
* put an icon at {{plainlinks|/favicon.ico|<code>/favicon.ico</code>}}, rather than the redirect to the landing page that it currently is
* The current landing page is fine by MediaWiki standards, but as the face of <code><nowiki>https://tas.bot</nowiki></code> it's not great. Way too many links (above the fold, that is), and the only picture of TASBot is the one in the sidebar. --yoshi
* The current landing page is fine by MediaWiki standards, but as the face of <code><nowiki>https://tas.bot</nowiki></code> it's not great. Way too many links (above the fold, that is), and the only picture of TASBot is the one in the sidebar. --yoshi
* <code>class="extiw"</code> links (e.g. to MediaWiki wiki) don't have indicator, only <code>class="external"</code>; affects both Citizen and Vector themes
** I'm like 90% sure this is a regression from early November '23 --yoshi
* upload images ([[Special:ListFiles|list existing media]])
* upload images ([[Special:ListFiles|list existing media]])
** please try reducing filesize with WebP: <code>magick convert input.png -define webp:lossless=true output.webp</code>
** please try reducing filesize with WebP: <code>magick convert input.png -define webp:lossless=true output.webp</code>
Line 62: Line 39:


* There are {{PAGESINCATEGORY:Incorrect_usage_of_first-party_templates}} [[:Category:Incorrect_usage_of_first-party_templates|pages with malformed template calls]]
* There are {{PAGESINCATEGORY:Incorrect_usage_of_first-party_templates}} [[:Category:Incorrect_usage_of_first-party_templates|pages with malformed template calls]]
* There are {{PAGESINCATEGORY:Needs_copyediting}} [[:Category:Needs_copyediting|pages which need copyediting]] (check spelling and grammar)
* finish moving event pages to <code>Category</code> namespace, and cleaning up names
* finish moving event pages to <code>Category</code> namespace, and cleaning up names
** [[GDQ]]&mdash;either move to {{redlink not wanted|:Category:Awesome Games Done Quick|Category:Awesome Games Done Quick}}, or keep it as a disambiguation page (moved to {{redlink not wanted|Games Done Quick}} ofc) and create the category page from scratch
** [[GDQ]]&mdash;either move to {{redlink not wanted|:Category:Awesome Games Done Quick|Category:Awesome Games Done Quick}}, or keep it as a disambiguation page (moved to {{redlink not wanted|Games Done Quick}} ofc) and create the category page from scratch
Line 68: Line 46:
* infobox for individuals
* infobox for individuals
** [[Template:Infobox_individual|Done]], <del>but it doesn't render correctly</del> close enough now thanks to TheMas
** [[Template:Infobox_individual|Done]], <del>but it doesn't render correctly</del> close enough now thanks to TheMas
** consider adding fields for country/flag and for pronouns
** <del>consider adding fields for country/flag and for pronouns</del>
*** Copied over [[Template:P|a template]] from Wikipedia, and while it currently only works for users of this wiki, I have an idea for extending it if that ends up being necessary. In the meantime I suggest '''not''' making dummy accounts for people. --yoshi
*** Copied over [[Template:Pronoun|a template]] from Wikipedia, and while it currently only works for users of this wiki, I have an idea for extending it if that ends up being necessary. In the meantime I suggest '''not''' making dummy accounts for people. --yoshi
*** Added a little template for flag emoji, and added a way to use that and {{t|p}} in the infobox. --yoshi
** could add email, but I'd like to have it deobfuscate on click (with JS) if it's going to be included, and with a personal site field and editors able to email each other via MediaWiki it would be rather redundant --yoshi
** could add email, but I'd like to have it deobfuscate on click (with JS) if it's going to be included, and with a personal site field and editors able to email each other via MediaWiki it would be rather redundant --yoshi
** consider adding field for (programming) languages spoken
** consider adding field for (programming) languages spoken
*** see [[Project:Babel|Babel overview]] and relevant notes above
*** see [[Project:Babel|Babel overview]] and relevant notes above
* consider redirecting (not sure how when <code>#REDIRECT</code> only allows local links) e.g. {{link or redlink not wanted|desync}} to {{TASVideos|/Glossary#Desync|TASVideos.org/Glossary#Desync}}
* consider redirecting (not sure how when <code>#REDIRECT</code> only allows local links; maybe [[wikipedia:Template:Soft_redirect]]?) e.g. {{link or redlink not wanted|desync}} to {{TASVideos|/Glossary#Desync|TASVideos.org/Glossary#Desync}}
** - introduces chance for link-rot
** - introduces chance for link-rot
*** + can leave notes for TASVideos editors
*** + can leave notes for TASVideos editors
Line 97: Line 76:
* <del>speaking of, need to suppress {{t|prevnext of type}} in {{t|infobox appearance}} when it matches {{t|prevnext appearance}}</del>
* <del>speaking of, need to suppress {{t|prevnext of type}} in {{t|infobox appearance}} when it matches {{t|prevnext appearance}}</del>
** simply commented-out the first few entries in {{t|prevnext of type}}; for finer control we could comment-out individual fields too --yoshi
** simply commented-out the first few entries in {{t|prevnext of type}}; for finer control we could comment-out individual fields too --yoshi
* Citizen is wrapping wikitables in a <code>div.citizen-table-wrapper</code>, preventing margin collapse (case in point, {{t|showcase}} appears to have a newline above the table as part of the transclusion, but it definitely doesn't)
* improve contribution docs for {{t|format run data}}
* improve contribution docs for {{t|format run data}}
** also deprecate that main template
** note that raw encodes do not belong in <code>recording</code> (should we have a separate field for that?)
* consider a single-source-of-truth for YouTube video IDs
** + would make it easier to see what content needs backing up
** - steeper learning curve for contributors
*** + it could be optional
**** - even so, it would contribute to cognitive load, and it being optional only means janitors have to pick up that workload
** + allows quickly checking if a source (read: video) is known
*** - not much of an improvement over site-wide page source search (linked above), and I think literally only I will use this --yoshi
** '''counter-proposal''': <code><nowiki>{{YouTube video/identifier|timestamp or other querystring}}</nowiki></code> (or dedicated param for timestamp might be better; see [https://lethal.miraheze.org/wiki/Template:Cite_YouTube this template] I wrote on another wiki for logic)
*** this should probably be optional, so:
*** - steeper learning curve for contributors ''adding sources'', but
*** + little extra cognitive load for contributors working with ''existing sources'';
*** - and still more work for janitors.
*** + trivial to create a subpage list, then those can be checked by archivist and edited or even put into categories
*** - identifiers wouldn't include the video ID so would still need page source search for that
* should media be categorised by event as well? if so, by individual events, or just by series?
* blank branches in <nowiki>{{#if}}/{{#switch}}</nowiki> should really be HTML comments for explicitness...


----
----

Latest revision as of 10:49, 6 September 2024

NEED MORE CONTENT in general (historians wanted). Fill out redlinks (and these, and also these) or work on a stub (list empty categories, list every article, list every category page).

Categories are arguably a direct upgrade to articles in that pages can have multiple parent categories, and categories have a nice UI for navigating to subpages. The longer URI is why you shouldn't just use them for everything.

All editing help and guidelines will be in the style guide.

If you need to grep in wikitext, use this (change srsearch=querytext).

For those of us used to Git, it can be a bit confusing to look at contribution logs because page moves/renames are applied retroactively.

The banners at the top of the site are MediaWiki:Sitenotice (for everyone) and MediaWiki:Anonnotice (extra banner for everyone who's not logged in).

TODOs for admins

Now approximately sorted by effort required!

  • There are 5 pages to delete
  • visual editor is showing PortableInfoboxen as just the header, no content; supposedly fixed in MW 1.40
  • can the PortableInfobox link an image's media page rather than hotlink?
  • if semantic citation markup is desired (and I believe it is), mw:Extension:Cite needs to be installed enabled --yoshi
  • current MediaWiki:Sitenotice is fairly unintrusive, but should we want to make it bigger in the future it should probably be dismissable—that requires mw:Extension:DismissableSiteNotice w/ $wgDismissableSiteNoticeForAnons = true
  • The current landing page is fine by MediaWiki standards, but as the face of https://tas.bot it's not great. Way too many links (above the fold, that is), and the only picture of TASBot is the one in the sidebar. --yoshi
  • upload images (list existing media)
    • please try reducing filesize with WebP: magick convert input.png -define webp:lossless=true output.webp
    • since we seem to have dealt with the bot problem, can we loosen the perms and let regular users upload?
  • There are 19 images/files missing copyright metadata
  • fix quick search API
    • I researched as far as 'Generators' + prefixsearch and gave up --yoshi
      • Update: IIRC I saw a JS error and, assuming that was related, chased that to the above docs. But the error is gone now and yet the search still sucks. --yoshi
  • consider adding {{#babel:}} template for user pages
    • I went ahead and added a template-based userbox; see Babel overview. It can even be used for programming languages, though it doesn't have any special handling for them at the time of writing. I've used the private-use code qhx for that, as you can see on my user page. --yoshi
  • we haven't needed a TASBot Wiki:Sandbox yet, but if we're expecting an influx of editors unfamiliar with MediaWiki, it may be a good idea, which raises the question of excluding it from Special:RecentChanges. I found this from 2011, and the modern equivalent appears to be the ChangesListSpecialPageStructuredFilters hook. IMO not worth messing with that. --yoshi

TODOs

  • There are 0 pages with malformed template calls
  • There are 1 pages which need copyediting (check spelling and grammar)
  • finish moving event pages to Category namespace, and cleaning up names
    • GDQ—either move to Category:Awesome Games Done Quick, or keep it as a disambiguation page (moved to Games Done Quick ofc) and create the category page from scratch
      • need someone to make the call here; should there be a page for GDQ as a whole, or not? --yoshi
    • MAGFest is all cleaned up and ready for new articles
  • infobox for individuals
    • Done, but it doesn't render correctly close enough now thanks to TheMas
    • consider adding fields for country/flag and for pronouns
      • Copied over a template from Wikipedia, and while it currently only works for users of this wiki, I have an idea for extending it if that ends up being necessary. In the meantime I suggest not making dummy accounts for people. --yoshi
      • Added a little template for flag emoji, and added a way to use that and {{p}} in the infobox. --yoshi
    • could add email, but I'd like to have it deobfuscate on click (with JS) if it's going to be included, and with a personal site field and editors able to email each other via MediaWiki it would be rather redundant --yoshi
    • consider adding field for (programming) languages spoken
  • consider redirecting (not sure how when #REDIRECT only allows local links; maybe wikipedia:Template:Soft_redirect?) e.g. desync to TASVideos.org/Glossary#Desync
    • - introduces chance for link-rot
      • + can leave notes for TASVideos editors
    • - not everyone can add to that glossary
      • + yet
    • counter-proposal: could instead make a {{TASVideosGloss}} and use {{TASVideosGloss|term}} instead of [[term]]
      • + easy on a technical level
      • - no way to see valid link targets without visiting TASVideos
      • - same problems as above re: "delegating" content to TASVideos
  • it seems reference lists e.g. Special:WhatLinksHere/Template:TASVideos don't differentiate between direct and transitive transclusions (that is, where the template is used as itself vs. where it's only used via another template)
    • worked around this by using search API e.g. this, but it's not ideal --yoshi
  • why are category pages wider than articles? affects both Citizen and Vector themes
    • this was an explicit choice (namespaces -1, 6, and 14 are Special, File, and Category, respectively):
@media screen and (min-width:1300px) {
	.ns--1, .ns-6, .ns-14 {
		--width-layout:var(--width-layout--extended);
	}
}
      • I'm not a fan of the postmodern max-width: 800px; margin: auto; epidemic, squishing all the text into the centre of the screen, but I understand it's a popular style. --yoshi
  • use shorthand redirects in {{prevnext appearance}}, like {{prevnext of type}} does already?
    • would help with float-right text being left-aligned in practice due to a line break (why), as you can see on ESA Summer 2019 (that was from {{prevnext of type}} which is now using shorthand)
      • found that removing the inner {{float right}} and making the outer {{float right}} dir="rtl" will work around this... but that feels like a bad idea --yoshi
  • speaking of, need to suppress {{prevnext of type}} in {{infobox appearance}} when it matches {{prevnext appearance}}
    • simply commented-out the first few entries in {{prevnext of type}}; for finer control we could comment-out individual fields too --yoshi
  • improve contribution docs for {{format run data}}
    • note that raw encodes do not belong in recording (should we have a separate field for that?)
  • consider a single-source-of-truth for YouTube video IDs
    • + would make it easier to see what content needs backing up
    • - steeper learning curve for contributors
      • + it could be optional
        • - even so, it would contribute to cognitive load, and it being optional only means janitors have to pick up that workload
    • + allows quickly checking if a source (read: video) is known
      • - not much of an improvement over site-wide page source search (linked above), and I think literally only I will use this --yoshi
    • counter-proposal: {{YouTube video/identifier|timestamp or other querystring}} (or dedicated param for timestamp might be better; see this template I wrote on another wiki for logic)
      • this should probably be optional, so:
      • - steeper learning curve for contributors adding sources, but
      • + little extra cognitive load for contributors working with existing sources;
      • - and still more work for janitors.
      • + trivial to create a subpage list, then those can be checked by archivist and edited or even put into categories
      • - identifiers wouldn't include the video ID so would still need page source search for that
  • should media be categorised by event as well? if so, by individual events, or just by series?
  • blank branches in {{#if}}/{{#switch}} should really be HTML comments for explicitness...

Qs for dwango:

  • I take it the focus here is on history, so how much technical information should be here vs on TASVideos?
    • tl;dr: we should put [technical info] on TASVideos. However, I have one pause here; there is a huge barrier to entry for TASVideos [wiki] at this time [...]
    • In essence, we should first and foremost ensure things like replay device and console verification documentation is complete (enough) on the TASVideos wiki. As CompuCat pointed out however, our needs and perspective is a bit different, and there's no harm in us also having technical details on the TASBot wiki with a perspective more geared toward live presentations at charity events. In fact, that's where I see the TASBot community as differentiated from the TASVideos side when it comes to on-hardware work; the TASBot community is centered around having our cute robot mascot play video games during public presentations, and our needs are going to involve things like proper presentation with visualization on camera that aren't relevant for just seeing if something syncs on hardware. To that end, I think there's room to have the core concepts explained from the different perspectives even if some of it may end up overlapping documentation on the TASVideos side. More documentation (so long as it isn't wholly inaccurate) is always better. There's another caveat here - despite my best efforts, it's still a lot harder for folks to edit wiki entries on TASVideos whereas anyone willing to share an email address is able to edit the TASBot Wiki
  • apart from Ambassadors, how should individuals be categorised?
    • DWYW
      • pages can be in multiple categories, so I guess could just have one cat per role/specialty?
    • to that end, a definition of "notability" for inclusion here would be helpful
      • anyone who was credited for any event/showcase