Locations/Guidelines: Difference between revisions
Tag: Undo |
(content in line with the recent revelations) |
||
| Line 1: | Line 1: | ||
{{Under construction | {{Under construction | ||
|reason = This | |reason = This is a work in progress while I figure out all the details of the new recommendations | ||
}} | }} | ||
= New Location Pages Guidelines = | = New Location Pages Guidelines = | ||
This document outlines the guidelines that are used in the construction and maintenance of the new Location pages on the wiki. The goal of these guidelines is to create maintainable pages | This document outlines the guidelines that are used in the construction and maintenance of the new Location pages on the wiki. The goal of these guidelines is to create maintainable pages. | ||
== What do we do with the old images and how do we use them on the new pages? == | == What do we do with the old images and how do we use them on the new pages? == | ||
''Shouldn’t we place images we have next to the relevant room text?'' '''No.''' If we do that, we create a tight coupling between the text and images. '''<u>The focus is on the text.</u>''' The images should ''feel'' optional. If we have an outdated or several outdated images next to the text the uninformed reader might think that the text is also outdated. If on the other hand, there are texts that don’t have an image the reader might assume that they are also outdated or not important if other rooms have several images. Images are also much harder to maintain. | ''Shouldn’t we place images we have next to the relevant room text?'' '''No.''' If we do that, we create a tight coupling between the text and images. '''<u>The focus is on the text.</u>''' The images should ''feel'' optional. If we have an outdated or several outdated images next to the text the uninformed reader might think that the text is also outdated. If on the other hand, there are texts that don’t have an image the reader might assume that they are also outdated or not important if other rooms have several images. Images are also much harder to maintain. All images should be placed in a gallery section. Images of entire departments are to be avoided. Instead, the Maps pages be linked to, to give the reader a zoomed-out perspective. | ||
All images should be placed in | |||
== Good Room text, Domain, and Separation of Concerns == | == Good Room text, Domain, and Separation of Concerns == | ||
The text should be a general description of the room in that department that applies to all stations. Because the text is supposed to apply to all stations the WHERE of a location is NOT written like: “left of x” or “below of y”. | The text should be a general description of the room in that department that applies to all stations. Because the text is supposed to apply to all stations the WHERE of a location is NOT written like: “left of x” or “below of y”. You don’t need to say, for example, “Genetics is in the medical department”. We are on the medical department section. It is implied. | ||
Room text should contain the following content: | Room text should contain the following content: | ||
* Describe any consistent visual features of the room (floor tile color, wall color, signs…) | * Describe any consistent visual features across all stations of the room (floor tile color, wall color, signs…) | ||
* State who works there with a link to the jobs page. | * State who works there with a link to the jobs page. | ||
* State the <u>major</u> room features and most important machine if applicable. Optionally link to the appropriate machine. | * State the <u>major</u> room features and most important machine if applicable. Optionally link to the appropriate machine. | ||
Revision as of 17:37, 25 June 2023
|
This page is currently under construction!
The following page is currently in the process of being created, is undergoing a major structural rework and/or is being moved. |
New Location Pages Guidelines
This document outlines the guidelines that are used in the construction and maintenance of the new Location pages on the wiki. The goal of these guidelines is to create maintainable pages.
What do we do with the old images and how do we use them on the new pages?
Shouldn’t we place images we have next to the relevant room text? No. If we do that, we create a tight coupling between the text and images. The focus is on the text. The images should feel optional. If we have an outdated or several outdated images next to the text the uninformed reader might think that the text is also outdated. If on the other hand, there are texts that don’t have an image the reader might assume that they are also outdated or not important if other rooms have several images. Images are also much harder to maintain. All images should be placed in a gallery section. Images of entire departments are to be avoided. Instead, the Maps pages be linked to, to give the reader a zoomed-out perspective.
Good Room text, Domain, and Separation of Concerns
The text should be a general description of the room in that department that applies to all stations. Because the text is supposed to apply to all stations the WHERE of a location is NOT written like: “left of x” or “below of y”. You don’t need to say, for example, “Genetics is in the medical department”. We are on the medical department section. It is implied.
Room text should contain the following content:
- Describe any consistent visual features across all stations of the room (floor tile color, wall color, signs…)
- State who works there with a link to the jobs page.
- State the major room features and most important machine if applicable. Optionally link to the appropriate machine.
- Describe the primary function of the room in general. Link to the department/job guide if applicable.
- Add any station specific differences.
- Add any miscellaneous notes.
The room pages should NOT explain how things work and should NOT go into detail on what things are used for.