Tekwiki Guidelines

From TekWiki
Revision as of 16:57, 6 December 2018 by Kurt (talk | contribs) (→‎Photos)
Jump to navigation Jump to search

This page provides guidelines on Tekwiki content. These are things to consider, not rigid rules.

Something is usually better than nothing. Perfectionism is harmful. It's ok to click "Save changes" when things aren't perfect. We can improve things later.

Text

Text should be in the style of an encyclopedia. Avoid unattributed text in the first person.

Scans

Favor any scan over no scan. The presence of free scans of manuals and other documentation is hugely important. In many cases the availability of a free scan makes the difference between an instrument being put in the trash versus being restored.

Favor high quality over small file size. What seems like a big file today will not seem so big in ten years.

Beware of software that claims to provide automatic image enhancement for scans. Automatic enhancement often corrupts the scan in ways that are hard to notice until later. Recommendation: Turn off all processing except for OCR. Always keep the raw scan in case it needs to be reprocessed for whatever reason. Maybe in twenty years, the automatic enhancement software will be reliable.

It is fine to upload scans that other people made for free distribution. Don't upload scans from companies like Artek, where the scan was done to make money.

Photos

Any photo is better than no photo. Prefer high-resolution, in-focus photos. Don't use photos from other websites if you think it will upset the owner of the photo. Prefer diffused lighting (no hard shadows), natural color balance, and good color rendition. Good color rendition often comes from having minimal glare, which often comes from diffused lighting. Prefer photos with low noise (without artificial denoising). Low noise often comes from having adequate light. Prefer photos without the in-camera flash. In-camera flashes usually result in high glare, hard shadows, and poor color rendition. When photographing an instrument, it's good to also get internal photos.

It is difficult to get a good photo of an oscilloscope showing its trace.

Quotes

If you quote a person or a document, make that clear by saying who/what is being quoted, and using blockquote tags. It's fine to have text in the first person inside of an attributed quote. For example, see the quote toward the top of the 524 page.

Units

On Tekwiki, we use a space between the number and the unit. We aren't rigid about imperial units versus metric, e.g., kg versus lb. Use one, or the other, or both.

Attribution

Sometimes another website has the perfect photo, or perfect document, or perfect table of data that's not available elsewhere. In those cases, it is fine to link to the external resource from a Tekwiki article. But we want Tekwiki to last for a long time, so it is good to make a local copy if possible, in case the external website (or just that resource) disappears. One way to do this is to make a copy of the resource, but to comment out the link to the local copy, and have the active link go to the external site. If the external site disappears, we can uncomment the local link and comment the external link.

Links

Internal links are helpful. When another instrument is mentioned in a page, make that a link in case readers want to explore that connection.

Categories

We have defined a number of categories. Pages are added to a category by putting a Category: tag in the page, typically at the bottom. See, for example, the bottom of the Type 82 page. This allows us to have an autogenerated page that lists all items in a category. If it seems appropriate to add a certain category tag to a page, do so. Also, if it seems appropriate to make a new category, do so.

Talk/Discussion Pages

If you have any doubt about a change that you want to make, or a change that somebody else made, feel free to edit the associated Talk/Discussion page (the "Discussion" link at the upper left of each page). Tekwiki administrators monitor those pages and will respond to questions. For example, if you want to start a new category but aren't sure, feel free to edit the Talk/Discussion page.

Collaboration

Feel free to improve text added by other people. If something is confusing, make it clear. If you're unsure, raise the question on the Talk/Discussion page.