Follow TV Tropes

Following

Proper Use of Comment Tags

Go To

HighCrate Since: Mar, 2015
#1: Jun 24th 2019 at 9:37:54 AM

Some problems with the use of comment tags on the wiki have come up recently, most notably on this ATT thread and in the unreleased work page cleanup thread. The responses we've gotten from moderation have been non-committal, but the problem doesn't seem to be going away, so I thought it was time to reach a proper consensus on it.

For those who aren't aware, comment tags are when two percent signs (%) are used to begin a line. This causes the line to be hidden on the live page, only visible when someone edits the page or view the page source.

The most common use of comment tags is to hide Zero Context Examples. The idea is that since ZCEs are such a common problem on the wiki, it's unreasonable to expect everyone who wishes to clean them up to be intensely familiar with every different work that requires cleanup. However, it's also not ideal to delete entries outright that might be salvaged by adding context. By hiding these entries, we are sending a message to future editors: "Hey, this entry is not okay as written, but if you're familiar enough with the work to know whether it's a valid example or not, please add context if so or delete if not!"

More recently, this same use case has been used on work pages for unreleased works. We have some new and relatively strict guidelines for what may be troped about a work prior to its release, and using comment tags to hide entries that don't adhere to the new policy seemed like a preferable alternative to mass-deleting entries and/or cutlisting a large number of pages that could conceivably be made acceptable with some work.

I also often see comment-tagged notes at the top of a page instructing editors to consult the Image Pickin' thread or the Page Quotes thread before making changes to those elements.

Less commonly, I've occasionally seen comment-tagged notes inserted into pages in alphabetical order where a trope would go that has been decided by consensus not to be a valid example, but has been persistently re-added by several different tropers. This is often accompanied by a link to a forum or ATT thread where consensus was reached. As long as people are willing to read and abide by the note (not a given), this is often a preferable alternative to locking an entire page just to deal with one contentious edit.

These latter two uses seem helpful and unproblematic, but some problems have arisen with the former two.

In the case of commenting out ZCEs, the theory is sound, but it often results in pages with more hidden than unhidden tropes, and they often stay that way for years. This strikes me as suboptimal, creating a cluttered editing environment.

More pressingly, in the course of cleaning up Speculative Troping and Zero Context Examples on works pages for unreleased works, I have noticed that several tropers have habitually taken to adding trope entries that most definitely do not adhere to the policies governing such pages, with comment tags already in place.

While there is no specific rule prohibiting this, it strikes me as a blatant attempt to make an end-run around the rules against Speculative Troping while staying just barely within the letter of the law.

The spirit of the policy is, "Experience the work, decide what tropes apply, and write up a trope entry with full context." It is not, "try to guess a priori what tropes apply to a work you're excited about but have not experienced, write up your best guess at a trope entry with partial, absent, or invented context, and then find out later whether your guess was right."

I propose that this behavior be made explicitly against the rules. I further propose that such pre-hidden entries can and should be deleted on sight, and the tropers who make such edits be PM'd with a link to this thread so that they understand why this is a problem.

The problem with excessive, cluttered page sources with hidden ZCEs is less pressing, but I think that it would be good to allow hidden ZCEs to be deleted after a reasonable waiting period, say a year. I don't think this is such a big deal as to warrant a dedicated cleanup effort, but it would be nice to clean up such long-term hidden entries in passing as I see them (which is largely how I handle ZCEs now anyway).

Thoughts?

Edited by HighCrate on Jun 24th 2019 at 9:44:44 AM

Fighteer Lost in Space from The Time Vortex (Time Abyss) Relationship Status: TV Tropes ruined my love life
Lost in Space
#2: Jun 24th 2019 at 9:59:11 AM

I really wish I could discover where the idea you reference came from so I could find a way to make it go back there, with extreme prejudice.

It has never in the history of our wiki been acceptable to add pre-commented example to articles. That's it, that's the rule, done.

The only time it is acceptable to use comment tags to hide examples is while cleaning up an existing article, to encourage users who see those invalid examples to fix them.

We could add this to How to Write an Example, if it isn't already there, but it falls under the basic principle that an example either is or is not valid. There is no in-between. If an example is speculative, does not fit the trope, has insufficient context, or is factually incorrect, it does not belong on the article. At all. Ever.

"It's Occam's Shuriken! If the answer is elusive, never rule out ninjas!"
HighCrate Since: Mar, 2015
#3: Jun 24th 2019 at 10:16:00 AM

[up] In my case, it comes from moderator SeptimusHeap in this ATT thread, where he wrote:

This has been done for some time. We don't have a specific rule against it so it ain't forbidden but the people who do so should be asked to write out proper context.

When I asked for clarification, e.g. does that mean I'm good to delete pre-commented entries on sight, I received silence.

In any case, it definitely strikes me as one of those things that was never in the spirit of the rules, but no specific rule was ever set down in writing against it just because nobody ever really thought about it until recently.

Edited by HighCrate on Jun 24th 2019 at 10:17:28 AM

rjd1922 he/him | Image Pickin' regular from the United States Since: May, 2013 Relationship Status: Love is for the living, Sal
he/him | Image Pickin' regular
#4: Jun 24th 2019 at 10:34:42 AM

I say commented-out examples should never be deleted unless they're outright wrong or from a leak. I don't think there should be a waiting period to delete them, because it's possible someone familiar with an obscure work could find an old, neglected trope page on it and expand it, and the commented-out ZCEs would help with that.

Keet cleanup
WarJay77 Big Catch, Sparkle Edition (Troper Knight)
Big Catch, Sparkle Edition
#5: Jun 24th 2019 at 10:45:05 AM

[up] I agree. The principal behind hiding them in the first place is that someone who knows the work may come along and save the page; outright deleting these examples is counterproductive, and defeats the purpose of hiding them at all.

I have no love for ZCEs; they're a plague upon the wiki. But they're one of the few big problems that can be fixed with enough time and and interest, not through deletions.

The only time I think I've ever deleted a ZCE is when a page was a no-context stub that had to be cut. Otherwise... Just leave 'em in purgatory.

Currently Working On: Incorruptible Pure Pureness
Fighteer Lost in Space from The Time Vortex (Time Abyss) Relationship Status: TV Tropes ruined my love life
Lost in Space
#6: Jun 24th 2019 at 10:47:25 AM

The issue is not whether one can delete ZCEs that have been hidden with comment markup. The general answer on that is no, but there's a discretionary component. If it's been hidden for months, nobody has fixed it, and you know that the example is not valid, go ahead and cut. Nobody'll miss it.

It is never, ever, ever, ever, ever, ever, ever, ever okay to add a brand new example with comment markup in place.

Edited by Fighteer on Jun 24th 2019 at 1:48:36 PM

"It's Occam's Shuriken! If the answer is elusive, never rule out ninjas!"
WarJay77 Big Catch, Sparkle Edition (Troper Knight)
Big Catch, Sparkle Edition
#7: Jun 24th 2019 at 10:57:56 AM

[up] Keyword being "not valid". That's only something somebody who knows the work would know. In that case, said person is in the position to fix the ZC Es in general, which does include removing invalid information.

One can't just go to some random low-context page and make the assumption that a ZCE example is invalid, unless it's somehow blatantly obvious just from the other tropes (like, a character with tropes such as Jerkass, The Sociopath and Slasher Smile is very unlikely to also be a Sweet Baker).

Currently Working On: Incorruptible Pure Pureness
Fighteer Lost in Space from The Time Vortex (Time Abyss) Relationship Status: TV Tropes ruined my love life
Lost in Space
#8: Jun 24th 2019 at 11:01:07 AM

That is correct. Don't delete it just because it's commented out. If you know it's incorrect, then it should indeed be removed.

"It's Occam's Shuriken! If the answer is elusive, never rule out ninjas!"
RallyBot2 Since: Nov, 2013 Relationship Status: I-It's not like I like you, or anything!
#9: Jun 24th 2019 at 11:56:16 AM

The only ZCEs that should get an insta-cut are if they are incorrect or misused in addition to being a ZCE. The example I usually like to give for this is character tropes pertaining to only one character when a Characters/ page already exists.

rjd1922 he/him | Image Pickin' regular from the United States Since: May, 2013 Relationship Status: Love is for the living, Sal
he/him | Image Pickin' regular
#10: Jun 24th 2019 at 12:37:40 PM

[up]Agreed, those can also be deleted.

Keet cleanup
WarJay77 Big Catch, Sparkle Edition (Troper Knight)
Big Catch, Sparkle Edition
#11: Jun 24th 2019 at 1:20:44 PM

Yeah, essentially misuse in any form can absolutely be deleted, but a lone ZCE is not necessarily misuse in and of itself, so should not be deleted just because "eh, nobody'll miss it".

Currently Working On: Incorruptible Pure Pureness
HighCrate Since: Mar, 2015
#12: Jun 24th 2019 at 3:00:07 PM

Obviously if you're familiar with a work and know for a fact that an entry is invalid, it should always be deleted. That has nothing to do with how much time has elapsed: if it was added two days ago and commented out yesterday, if you know it's invalid, it's not going to get any less invalid over time.

Still, there comes a point where, no, I can't prove with absolute certainty that it's invalid because I'm not familiar with the work, but let's get real. This commented-out entry has been sitting here gathering dust for literally a decade. No one's come to fix it in all that time, and on the off chance anyone ever does come across this page, they'll just have to decide on their own that the trope applies and add it from scratch, because the commented-out entry that reads:

...isn't doing anyone any good any more.

Edited by HighCrate on Jun 24th 2019 at 3:02:23 AM

WarJay77 Big Catch, Sparkle Edition (Troper Knight)
Big Catch, Sparkle Edition
#13: Jun 24th 2019 at 3:04:16 PM

[up] But what good does deleting it outright do? The pages with the least-likely-to-be-saved ZC Es are for real obscure works that may not have been touched since their creation. While yes, it's unlikely anyone will come along and fix them, who will be editing the page to be bothered by said hidden ZC Es in the first place?

Currently Working On: Incorruptible Pure Pureness
HighCrate Since: Mar, 2015
#14: Jun 24th 2019 at 3:09:46 PM

[up] On a work page, sure. But there are also trope pages that are cluttered up with hidden ZCEs from obscure works.

WarJay77 Big Catch, Sparkle Edition (Troper Knight)
Big Catch, Sparkle Edition
#15: Jun 24th 2019 at 3:13:05 PM

[up] True, but deleting a ZCE just because it's from an obscure work, and thus less likely to be fixed, kinda runs afoul of No Such Thing as Notability, because you'd have to assume that the work is so unknown that nobody would ever find that ZCE and give it a fix.

Currently Working On: Incorruptible Pure Pureness
HighCrate Since: Mar, 2015
#16: Jun 24th 2019 at 3:30:18 PM

No Such Thing as Notability refers to every work's right, no matter how obscure, to a page, as long as they're someone out there with the knowledge and motivation to make one.

Here, the exact problem is that there apparently is no one with the knowledge and motivation to make a proper entry, so why should we continue to let the improper ones clutter the page source?

Edited by HighCrate on Jun 24th 2019 at 3:30:52 AM

WarJay77 Big Catch, Sparkle Edition (Troper Knight)
Big Catch, Sparkle Edition
#17: Jun 24th 2019 at 3:39:07 PM

[up] What if there is someone with that knowledge and motivation, but they've not yet joined the site?

The only case I can see for deleting ZCEs, beyond the ones already stated (trope misuse, stub page cut, etc), is if a page gets way too long to edit properly, and deleting the ZCEs will cut down on page length.

One potential benefit to keeping hidden ZCEs around is that they're useful when wick-checking for a trope. A mass amount of ZCEs points to major problems with the trope itself; removing those wicks on an assumption they'll never be fixed just makes it harder to realize when a trope is suffering.

Currently Working On: Incorruptible Pure Pureness
Fighteer Lost in Space from The Time Vortex (Time Abyss) Relationship Status: TV Tropes ruined my love life
Lost in Space
WarJay77 Big Catch, Sparkle Edition (Troper Knight)
Big Catch, Sparkle Edition
#19: Jun 24th 2019 at 4:44:47 PM

[up] Do they not?

-Checks-

No, they do. I just tested it with Revealing Continuity Lapse on a sandbox page— wick showed up just fine.

Currently Working On: Incorruptible Pure Pureness
Fighteer Lost in Space from The Time Vortex (Time Abyss) Relationship Status: TV Tropes ruined my love life
crazysamaritan NaNo 4328 / 50,000 from Lupin III Since: Apr, 2010
NaNo 4328 / 50,000
#21: Jun 26th 2019 at 2:08:12 PM

If an example is speculative, does not fit the trope, has insufficient context, or is factually incorrect, it does not belong on the article. At all. Ever.
You contradict yourself; you just said commented-out examples stay unless they are invalid. Which means examples with insufficient context or speculative troping are allowed on pages, as long as they're commented-out. Troper A adds a ZCE, Troper B comments it out and maybe sends a notifier, but the ZCE stays until Troper C comes along. Troper A adds a commented-out ZCE, Troper B maybe sends a notifier, but the ZCE stays until Troper C comes along.
it's possible someone familiar with an obscure work could find an old, neglected trope page on it and expand it, and the commented-out ZCEs would help with that.
It is possible for Troper C to come along, but what has been demonstrated to happen is that we get a lot more of Troper A than Troper C. The existence of commented-out ZCEs is viewed as implicit permission to bloat pages with hidden examples.
there's a discretionary component. If [...] you know that the example is not valid, go ahead and cut.
That's not a discretionary component. If you know an example is misuse, you cut/discuss. The timeframe on when you should remove an invalid example is right now. Existing policy for ZCE is "don't remove unless you know the example is invalid", with no discretion allowed. The proposal is to introduce discretionary powers so that ZCEs can be removed without knowledge of the work.
A mass(ive) amount of ZCEs points to major problems with the trope itself; removing those wicks on an assumption they'll never be fixed just makes it harder to realize when a trope is suffering.
That isn't a reciprocal problem; a work page with a massive amount of ZCEs is not a reason to go to TRS. The problems of a work page are the same if all ZCEs are deleted or commented-out.
Besides, pre-hidden ZCE doesn't really point to major problems with the trope itself, but to tropers trying to avoid punishment for adding the ZCE in the first place.

Link to TRS threads in project mode here.
WarJay77 Big Catch, Sparkle Edition (Troper Knight)
Big Catch, Sparkle Edition
#22: Jun 26th 2019 at 2:18:07 PM

[up] What I meant was that a trope that has more Zero-Context Examples than Properly written examples is probably occurring because of an issue with the trope itself. Say, if all of the ZCEs for Appearance Tropes were just deleted outright, would we even have recognized that the tropes themselves were the cause of the problem- that there even is a problem at all?

Sure, this isn't always the case, but it can easily be a very obvious symptom of a bigger problem. And yes, I'm talking about misused tropes, not bad work pages. Those are always just the result of laziness or inexperience.

Currently Working On: Incorruptible Pure Pureness
crazysamaritan NaNo 4328 / 50,000 from Lupin III Since: Apr, 2010
NaNo 4328 / 50,000
#23: Jun 27th 2019 at 10:21:44 AM

What I meant was that a trope that has more Zero-Context Examples than Properly written examples is probably occurring because of an issue with the trope itself.
I'm sorry if I was misrepresenting you. My goal was to point out examples are reciprocal, but ZCE use for tropes doesn't describe reciprocal problems for works. Preserving ZCE means we are preserving "laziness or inexperience", regardless of work/trope pages.

Link to TRS threads in project mode here.
naturalironist from The Information Superhighway Since: Jul, 2016 Relationship Status: TV Tropes ruined my love life
#24: Jun 27th 2019 at 12:21:07 PM

I was under the impression that it was ok to delete commented out ZC Es when a work is renamed or redefined, and I have been doing so while doing wick cleanup for various TRS projects. Is that not the case?

"It's just a show; I should really just relax"
Asherinka Since: Jan, 2018
#25: Jun 27th 2019 at 12:44:39 PM

I don't see that much of an issue with commented out ZC Es or examples for unrealeased pages. Viewers don't see them, and it is easier for editors to expand on ZC Es than to think of tropes that apply entirely on their own. As for unreleased pages, it is a fine balance between people who want to add tropes based on trailers etc and those who are afraid of "speculations" (though, seriously, last time I've seen all those commented out examples added to "Infinity War" page on the release date, 95% of them turned out to be correct).

Of course, blatantly wrong examples should be deleted rather than commented out.

Edited by Asherinka on Jun 27th 2019 at 10:46:07 PM


Total posts: 50
Top