Minecraft Wiki:Style guide/Redstone

The following is a proposal for a style guide for redstone circuit write-ups. Even though it's in my user namespace, please feel free to improve it with edits (though obviously I or anyone else might change it back or change it further). If you just want to talk about the proposal, please do it on the discussion page and keep this page just for the proposal.

Descriptions
n/a

Usage
Describe the purpose of the circuit. …

When writing up a number of circuits which all provide the same function, consider using only a single usage paragraph to cover all of them. For example, if you are writing up a number of AND Gates, you could use a single usage paragraph to discuss the purpose of AND Gates and then move on to describing the different ways to build an AND Gate without having to duplicate a discussion of their usage with each circuit description.

The usage paragraph is the only paragraph that should be considered required for every circuit (or for a set of circuits which provide the same function).

Nomenclature/Terminology
Explain any new terminology used when naming or discussing this circuit. If explaining the terminology would be complicated enough to overwhelm the discussion of the circuit itself, consider linking to an explanation of the terminology provided somewhere else. If no new terminology is used, you can omit this paragraph.

Like the usage paragraph, this paragraph may be needed only once for a set of circuits which provide the same function.

Examples:


 * 1) Edge Detector Circuits are named for the length of the pulse they generate and for whether they detect the rising or falling edge of a pulse (or both). For example, a "1-tick Rising Edge Detector" would generate a 1-tick pulse output whenever the its input changes from OFF to ON. To further differentiate edge detectors of the same type, add more descriptive terms to the beginning of the name -- for example, "Repeater-Piston 1-tick Rising Edge Detector".
 * 2) The T Flip-Flop is a bistable circuit (its output doesn't change until it receives new input).

Construction
…

If construction is obvious from screenshots and/or schematics, you can omit this paragraph.

Considerations
(when to use this paragraph)

Possible considerations include:
 * Comparisons to other circuits which provide the same function
 * material cost
 * compactness
 * Behavior as a sub-circuit
 * signal delay
 * pulse length modification
 * Dependence on bugs or glitches which might be patched later

If there are no important considerations, you can omit this paragraph.

Screenshots
Along with redstone schematics and written explanations, screenshots help to illustrate the correct way to construct redstone circuits. Circuits should be built and shot in a consistent way so that users can quickly learn to identify which blocks in an image are part of the circuit and what they do, and which blocks are there to help explain it, etc.

This part of the style guide is based on an initial proposal by Supuhstar.

Building the Circuit

 * Background: Circuits should be built and shot in front of a plain, non-distracting background.
 * The preferred background is a grass block superflat world, with no other blocks or mobs in the picture.
 * Other possible backgrounds might include: the void, the sky (for under-shots, with clouds turned off), or other superflat worlds made from sandstone, iron blocks, glass, etc.
 * Positioning: Build circuits off the ground (free-floating in the air) so that they can be shot from any direction and so that it's clear exactly which blocks are part of the circuit.
 * Blocks: Use the following blocks to build the circuit and then remove all unnecessary blocks:
 * Redstone Blocks: Use redstone torches, wire, and repeaters, as needed.
 * Solid Blocks: Use a gold block for all solid blocks that are necessary to the circuit (to support redstone torches, wire, and repeaters or to provide power to another element of the circuit, etc.).
 * If, for some reason, you're building the circuit in a Survival world and you don't have enough gold, sandstone blocks are an acceptable substitute (maybe your only access to Minecraft is a school Survival server or something). But please consider starting a Creative world and building it properly! Gold blocks give better contrast to redstone wire than sandstone or yellow wool and match the appearance of redstone schematics.
 * Upside-down Slabs: Use a stone slab for upside-down slabs required by the circuit.
 * Only use upside-down slabs when they are necessary to the circuit (because they can act as diodes, to avoid cutting redstone below, to avoid powering a block in that location, etc.).
 * Where upside-down slabs, upside-down stairs and glowstone can be used interchangeably in a circuit, use stone slabs (by shape and color they provide the greatest contrast to surrounding gold blocks, making it easier to identify their purpose in the circuit).
 * Moving Blocks: Use a lapis lazuli block for all blocks intended to be moved back and forth by a sticky piston (they're easily distinguishable from gold blocks and stone slabs and we have to use them for something!). This helps to illustrate the moving parts of a piston-based circuit.
 * Other Blocks: Use any additional blocks required by the circuit (such as pistons) or necessary to illustrate the purpose of the circuit (for example, a circuit intended to control a door should include the door in the screenshot).
 * Input/Output Lines: When it would be helpful to understand the circuit, include additional blocks outside of the circuit to illustrate how signals enter and exit the circuit.
 * Input lines should consist of at least two blocks of light blue wool with an unpowered lever on top of the first and redstone wire on the other(s) leading into the circuit.
 * Output lines should consist of at least two blocks of pink wool with redstone wire on the first block(s) leading out of the circuit to a redstone lamp on top of the last block.
 * Optional: When combining smaller sub-circuits into larger circuits, consider illustrating the division with two pink wool blocks with redstone wire on top leading out of the first sub-circuit connecting directly (or eventually) to two blue wool blocks with redstone wire on top leading into the next sub-circuit.

Taking a screenshot

 * Preparation: Before taking a screenshot, take the following steps:
 * Remove or deactivate mods that would affect the screenshot (unless they're specifically about a mod, all Minecraft Wiki screenshots should represent Minecraft "out-of-the-box"). Mods that wouldn't affect the screenshot, or would get cropped out later, are fine.
 * Set Texture Pack to Default (see above).
 * Set Graphics to Fancy.
 * Set FOV to Normal (the lowest setting, to minimize perspective distortions).
 * Set Particles to Minimal (to remove particles from redstone torches which might obscure or be mistaken for redstone wire).
 * Set Smooth Lighting to ON (to remove distracting block shadows).
 * Set Clouds to OFF (only if you're intending to use the sky as a backdrop).
 * Set view to first-person (you shouldn't be in the shot). Use F5 to switch to first-person.
 * Turn off the GUI by pressing F1.
 * Taking the Shot:
 * Angle: Make sure the entire circuit is in the picture, including input/output lines and other illustrative blocks if present. Make sure there is additional space around the circuit in your framing so that it has a nice border and you have room to do some cropping later. Try to find an angle that illustrates all important elements of the circuit, but some circuits may require multiple angles/shots to illustrate everything.
 * Stand on a block rather than flying over the circuit. Flying expands your FOV which increases perspective distortion, so standing is better for taking pictures. The block can be in any position that gives you a good shot, and if you need to take the picture again the block will make it easier to get back in position.
 * Make sure no mobs have wandered into frame, and that there are no other stray entities (such as dropped items) that would clutter the shot.
 * Lighting: Take screenshots in the daytime, unless necessary to illustrate a feature of the circuit (if you have command privileges, use /time set 6000 to set the time to noon right before the shot).
 * Press F2 to take the screenshot (or use your own screen capture software).

Finishing Up

 * Editing: Screenshots may need clean-up to improve clarity, but this may require some knowledge of image editing software. If you don't know how to do this, or can't, go ahead and upload your image -- hopefully someone will fix your image later (yay, wikis!).
 * Cropping: Crop the image so that the circuit takes up most of the picture, but leave some border so the circuit isn't crowding the edge.
 * Color Adjustment: Some screenshots may need their color adjusted to improve clarity (especially screenshots of oscilloscopes while the game is paused and dimmed).
 * File Type: All uploaded screenshots should be of type .png (Portable Network Graphic). F2 screenshots are PNGs by default, but if you use other screen capture software you may need to convert the image to a PNG with image editing software.
 * Upload the image to the Minecraft Wiki.
 * Start at the Upload File page.
 * Use the Browse button to find the image on your computer.
 * Add a description!
 * Set the Licensing menu to "This file is a screenshot of/uses textures from Minecraft".
 * Check everything and then hit the Upload File button.
 * Add the screenshot to an article. Images that aren't used by articles may get deleted after a while.
 * To add a default thumb like the example screenshot above, use FILENAME.

Schematics
n/a

Sample Redstone Circuit Write-Up
n/a