Minecraft Wiki:Projects/Refactoring edition specific information

About this project
There are now five distinct versions of Minecraft, each with certain characteristics that are not universally shared by the others:
 * Java Edition
 * Bedrock Edition
 * Legacy Console Edition
 * Education Edition
 * New Nintendo 3DS Edition

Most of our articles were originally written to describe Java Edition. As new versions were added, we inserted information about them and tagged it with the Exclusive and only templates to identify which facts apply to which versions. These templates have worked well enough as a stopgap, but there are shortcomings. The work of this project is to address the following flaws and make our articles easier for our readers to read and use and easier for our editors to edit.

Shortcomings of the current method

 * 1) The current templates don't support New Nintendo 3DS Edition, and only support Education Edition at the article level.
 * 2) We have no way to tag article sections, paragraphs, groups of paragraphs, or groups of statements as edition-specific information.
 * 3) We have no standardized way to tag non-sentential information, such as in infoboxes, tables, captions, etc.
 * 4) An individual tagged statement is only marked at the end. Readers are thus forced to read, then ignore, information that's not relevant to them.
 * 5) Even if a reader looks ahead to the marker note and skips irrelevant information, their flow is interrupted and reading is hard because the information they want is scattered.
 * 6) Even relevant marker notes are sometimes long and disruptive to reading, especially after a statement that applies to many versions.
 * 7) The marker notes are superscripted and in brackets like editorial notes, which generally means they can be ignored when reading casually. But if you actually read the text that way the statements are often contradictory. The superscripted form isn't actually appropriate, because these aren't really editorial notes.
 * 8) Having no way to tag a series of statements, we've often tagged only the last statement in the series, making it ambiguous what the marker note includes.
 * 9) When information specific to one version isn't true for another version, but we don't have the corresponding information for the second version, we often didn't tag anything because our approach has been to present contrasting information. For example, we knew spawning worked differently in Bedrock, but we didn't have any details, so we never marked the Java spawning as Java-specific. Information about villages is another example, and there may be many others.
 * 10) When information applies to most versions, coding the template is tedious because you have to list a lot of versions.

Planning Stage

 * 1) (Current) Complete the preceding list of shortcuts.
 * 2) (Future) Discuss and choose a global strategy for presenting edition-specific information in a way that best serves readers and editors. (Don't forget IP readers!)
 * 3) (Future) Discuss how to implement the chosen strategy using templates and/or other means such as page indicators.
 * 4) (Future) Create a list of articles that need refactoring to fit the strategy.

Implementation Stage

 * 1) (Future) Create and/or update the templates.
 * 2) (Future) Refactor articles.

Members
To join the project, add your signature to the bottom of this list using.

– Auldrick (talk &middot; contribs) 17:21, 7 June 2018 (UTC)