Wiki:Page Structure/Elements: Difference between revisions

Content added Content deleted
No edit summary
Tag: Manual revert
 
(13 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Extraction Sidebar}}
This guide depicts the standard format for all element pages currently on and to be added to this wiki. While some elements may require additional information, or reduced coverage in the described areas, we recommend future page creators begin with the following as a base.
The introductory section of the page should include the '''name of the element''' in bold, the [[type of element]] it is (specifically the parent category, such as [[Logic Puzzle]] for [[Masyu]] or [[Decryption]] for [[Alphanumeric Substitution Cipher]]), and basic information about the element, including the following:


* A brief overview of how the element functions at a base level.
==Basic Information==
* Some cultural information about the element (if applicable), such as popularity outside of hunts.
Element pages are a bit more difficult to standardize than hunts or puzzles, as we have a wide range of what constitutes an "element". As such, this guide is only going to be a baseline, with a few notes for specific cases.
* Any "Not to be confused with..." notes.


This section should also include a lead-in sentence to any Subpage sections, if applicable.
Most of the information given on an element page should be explaining the element in as much detail as possible, and describing the forms it may take within a puzzle. Avoid using specific examples, as there should be a separate section beyond the basic information for notable ones. If an element is a puzzle type, for example, explain how that puzzle type works, and provide visual examples of a puzzle and solution. This should be especially true for logic puzzles, in which a visual can dramatically increase the reader's understanding of the mechanics.


==== Subpages (Name can be changed based on category) ====
As many elements are topics that may be covered on other wikis (such as Wikipedia), do not be afraid to link to other wikis when summarizing a particular topic. Since these pages should not replace the need for other wiki research, summaries should stay relatively minimal, and should definitely not plagiarize already-existing lists or wiki articles.
'''NOTE: This section is only applicable to upper-level pages. For variations on individual elements rather than categories, use Puzzle Applications.'''


This section may be repeated if multiple subcategories are being created, like in [[Word Puzzle]].
==Notable Examples==
Since categorization around elements is done via puzzle pages, element pages should not have much for categorization beyond grouping together similar types (such as Logic Puzzles or Physics Topics). Instead, the focus should be on notable examples of an element's use, puzzles that either were the first to use a particular element in a hunt, or utilized it in a way that hadn't be done before. Since notability is subjective, check with a senior editor when unsure, but otherwise trust your own judgement. If an editor deems a particular puzzle's use non-notable, it will be removed at no detriment to you.


Subpage sections should list all pages that are direct children to the page they are being written for. The preferred format is a bulleted list with links to the subpages and one-or-two-sentence blurbs about the element. A subpage section may also include a short description before the list, to further explain the categorization.
=Example=
The following is an example of a properly-structured Element page.


* [[Element]] - This is a blurb.
* [[Element]] - This is a blurb.
* [[Element]] - This is a blurb


== Background ==
'''NOTE: This section is optional.'''


Any historical background for a particular element, especially [[List of Puzzle Elements#Content Elements|Content Elements]], goes here. Do '''not''' worry if an element does not have significant historical precedents, as many will not, but those that do deserve recognition.


Information about an element's use outside of puzzling as a whole is also welcome, particularly for extraction elements that have a non-puzzle origin.
Masyu (ましゅ, ''Mashu'', IPA [maɕu͍]; translates as "evil influence") is a type of [[Path Drawing (Logic Puzzle Type)|path-drawing]] [[Logic Puzzle|logic puzzle]] designed and published by Nikoli. It is played on a rectangular grid of squares, some of which contain circles; each circle is either "white" (empty) or "black" (filled). The goal is to draw a single continuous non-intersecting loop that properly passes through all circled cells. The loop must "enter" each cell it passes through from the center of one of its four sides and "exit" from a different side; all turns are therefore 90 degrees.
[[File:Masyu Example.png|thumb|An unsolved Masyu puzzle.]]
[[File:Masyu Example Solution.png|thumb|Solution to the above Masyu example.]]
The two varieties of circle have differing requirements for how the loop must pass through them:


== Puzzle Applications ==
* White circles must be traveled straight through, but the loop must turn in the previous and/or next cell in its path.
'''NOTE: This section is likely not applicable to upper-level element pages.'''
* Black circles must be turned upon, but the loop must travel straight through the next and previous cells in its path.


An in-depth description of how an element has been applied in different ways within actual puzzles, including notable variations. If a variation merits its own page, a brief description of it will suffice for this page, along with a link to its own page. If not, a subsection within the Puzzle Applications heading is appropriate.
Variations include those that involve grey circles, which either are ambiguously white or black, or signify a turn that is not 90 degrees, and puzzles in which certain spaces are required to be visited by the path.


Images that help illustrate how a puzzle functions, particularly those with captions, are also recommended, particularly with regard to puzzle type.
==Notable Examples==

*[[Notable Masyu Puzzle 1]]
== Strategy ==
*[[Notable Masyu Puzzle 2]]
When applicable, it can be useful to provide strategies for solving a particular puzzle type, or deal with a particular puzzle element. Strategy for most elements can be divided into one of two subheadings. While the exact text presented on a page can be changed to fit the flow of the article, or specify the action being taken to approach an element (such as "Translation" for a cipher, or "Solving" for a puzzle type), the default is as follows:
*[[Notable Masyu Puzzle 3]]

*[[Notable Masyu Puzzle 4]]
=== Identification ===
Tips on how to identify the use of an element should go here. This includes keywords that hint the element, and puzzle qualities that lend themselves well to the use of particular elements (such as equal-length answers for [[Diagonalization]])

=== Solving ===
Tips on how to actually approach an element or puzzle type should go here. At minimum, these should include any general tips that apply to the element (such as focusing on "gimme" clues in any clue-based puzzle type). At best, it should include specific strategies that will help with most non-twist versions of a particular element. Additionally, avoid giving tips for niche variants or known twists from specific puzzles, as this can act as both a spoiler, and is likely to not be applicable in many situations.

Lastly, don't be afraid to add links to more in-depth strategy guides or solving resources if including all of their information would bloat the section.

== Notable Examples ==
This section should include links to specific puzzle pages that utilize this element in a way that is considered "notable". While there is no set criteria for notability in these cases, a general guideline is that if the element is relatively unique already, any use is notable, and if an element is more commonplace (like [[Dropquote]]), a mix of puzzles that play it straight and puzzles that put a twist on it are preferred, so a reader can compare and contrast the examples.

* [[Puzzle Name]] - Explanation of how the element is used.
* [[Puzzle Name]] - Explanation of how the element is used.
* [[Puzzle Name]] - Explanation of how the element is used.

== See Also ==

* Elements related to this one (If Applicable)
* A link to the category page for puzzles involving this element.

== Sidebar ==
All element pages should have a sidebar added to it, assuming one for its category is available. Currently, all sidebars are collected [[Wiki:Element Sidebars|here]], and can be updated to accommodate new elements that fit within their structure. Select the one that either contains the element you're writing for, or will contain it once the sidebar has been updated.

No additional information needs to be added to the template once it has been added to the element page; any updates need to be made on the sidebar's template page.

== Categories ==
This section header should be deleted. This is only a note about adding categories to an element page.

Element pages belong to the following categories:

* Elements
* The category linked to in the page's sidebar
* Any categories named for their parent pages (such as the top level three categories of Structure, Content, and Flavor elements)


[[Category:Page Structure]]
[[Category:Page Structure]]

Latest revision as of 13:06, 5 March 2024

The introductory section of the page should include the name of the element in bold, the type of element it is (specifically the parent category, such as Logic Puzzle for Masyu or Decryption for Alphanumeric Substitution Cipher), and basic information about the element, including the following:

  • A brief overview of how the element functions at a base level.
  • Some cultural information about the element (if applicable), such as popularity outside of hunts.
  • Any "Not to be confused with..." notes.

This section should also include a lead-in sentence to any Subpage sections, if applicable.

Subpages (Name can be changed based on category)[edit | edit source]

NOTE: This section is only applicable to upper-level pages. For variations on individual elements rather than categories, use Puzzle Applications.

This section may be repeated if multiple subcategories are being created, like in Word Puzzle.

Subpage sections should list all pages that are direct children to the page they are being written for. The preferred format is a bulleted list with links to the subpages and one-or-two-sentence blurbs about the element. A subpage section may also include a short description before the list, to further explain the categorization.

Background[edit | edit source]

NOTE: This section is optional.

Any historical background for a particular element, especially Content Elements, goes here. Do not worry if an element does not have significant historical precedents, as many will not, but those that do deserve recognition.

Information about an element's use outside of puzzling as a whole is also welcome, particularly for extraction elements that have a non-puzzle origin.

Puzzle Applications[edit | edit source]

NOTE: This section is likely not applicable to upper-level element pages.

An in-depth description of how an element has been applied in different ways within actual puzzles, including notable variations. If a variation merits its own page, a brief description of it will suffice for this page, along with a link to its own page. If not, a subsection within the Puzzle Applications heading is appropriate.

Images that help illustrate how a puzzle functions, particularly those with captions, are also recommended, particularly with regard to puzzle type.

Strategy[edit | edit source]

When applicable, it can be useful to provide strategies for solving a particular puzzle type, or deal with a particular puzzle element. Strategy for most elements can be divided into one of two subheadings. While the exact text presented on a page can be changed to fit the flow of the article, or specify the action being taken to approach an element (such as "Translation" for a cipher, or "Solving" for a puzzle type), the default is as follows:

Identification[edit | edit source]

Tips on how to identify the use of an element should go here. This includes keywords that hint the element, and puzzle qualities that lend themselves well to the use of particular elements (such as equal-length answers for Diagonalization)

Solving[edit | edit source]

Tips on how to actually approach an element or puzzle type should go here. At minimum, these should include any general tips that apply to the element (such as focusing on "gimme" clues in any clue-based puzzle type). At best, it should include specific strategies that will help with most non-twist versions of a particular element. Additionally, avoid giving tips for niche variants or known twists from specific puzzles, as this can act as both a spoiler, and is likely to not be applicable in many situations.

Lastly, don't be afraid to add links to more in-depth strategy guides or solving resources if including all of their information would bloat the section.

Notable Examples[edit | edit source]

This section should include links to specific puzzle pages that utilize this element in a way that is considered "notable". While there is no set criteria for notability in these cases, a general guideline is that if the element is relatively unique already, any use is notable, and if an element is more commonplace (like Dropquote), a mix of puzzles that play it straight and puzzles that put a twist on it are preferred, so a reader can compare and contrast the examples.

See Also[edit | edit source]

  • Elements related to this one (If Applicable)
  • A link to the category page for puzzles involving this element.

Sidebar[edit | edit source]

All element pages should have a sidebar added to it, assuming one for its category is available. Currently, all sidebars are collected here, and can be updated to accommodate new elements that fit within their structure. Select the one that either contains the element you're writing for, or will contain it once the sidebar has been updated.

No additional information needs to be added to the template once it has been added to the element page; any updates need to be made on the sidebar's template page.

Categories[edit | edit source]

This section header should be deleted. This is only a note about adding categories to an element page.

Element pages belong to the following categories:

  • Elements
  • The category linked to in the page's sidebar
  • Any categories named for their parent pages (such as the top level three categories of Structure, Content, and Flavor elements)