Locations/Guidelines - Revision history

NaniByte: /* New Location Pages Guidelines */ added another link example of good location format

2024-04-08T10:06:14Z

New Location Pages Guidelines: added another link example of good location format

← Older revision		Revision as of 10:06, 8 April 2024
Line 1:		Line 1:
	= 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 merge the old tab based system while preserving as much content as viable and creating more maintainable pages. Check out [[genetics]] for a good example of a merged and rewritten page.		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 merge the old tab based system while preserving as much content as viable and creating more maintainable pages. Check out [[genetics]] or [[arrivals]] for a good example of a merged and rewritten page.
	== 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. 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.		''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.

NaniByte: not wip anymore (as much as anything can be here)

2024-04-08T10:03:59Z

not wip anymore (as much as anything can be here)

← Older revision		Revision as of 10:03, 8 April 2024
Line 1:		Line 1:
	~~{{Under construction~~
	~~\|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 merge the old tab based system while preserving as much content as viable and creating more maintainable pages. Check out [[genetics]] for a good example of a merged and rewritten page.		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 merge the old tab based system while preserving as much content as viable and creating more maintainable pages. Check out [[genetics]] for a good example of a merged and rewritten page.

NaniByte: content

2023-06-25T18:15:35Z

content

← Older revision		Revision as of 18:15, 25 June 2023
Line 3:		Line 3:
	}}		}}
	= 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 merge the old tab based system while preserving as much content as viable and creating more maintainable pages. Check out [[genetics]] for a good example of a merged and rewritten page.
	== 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. 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.		''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.

NaniByte: content in line with the recent revelations

2023-06-25T17:37:43Z

content in line with the recent revelations

← Older revision		Revision as of 17:37, 25 June 2023
Line 1:		Line 1:
	{{Under construction		{{Under construction
	\|reason = This ~~page~~ is a ~~WIP~~ while I figure out all the details of the new ~~guidelines~~		\|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~~, NOT the most comprehensive ones.~~		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.
	~~== Issues with the old pages (should be removed once the renovations are done) ==~~
	The main issue with the old pages style of documentation is that it’s not suited to our type of community. There is too much content. An average of 10 rooms across 10 departments across 5 stations is 500('''!''') required images and text descriptions. This leads to huge swings in quality and huge likelihood that the text/image is outdated.
	== 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 ~~the~~ gallery section~~. There should be no more than three images of the same type (e.g., medbay storage) in the gallery. The reader does not need to see every variation of the medical storage room~~. Images of entire departments are to be avoided. Instead, the Maps pages ~~and the Web Map should~~ be linked to, to give the reader a zoomed-out perspective.

	The reader should be informed of the fact that the images are probably outdated, but since the text is not directly connected it should reason that the same should not be assumed of the text. This should give the distinct impression that the images are optional and for just getting the ''general'' idea.
	== 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”. ~~Also, you~~ don’t need to say, for example, “Genetics is in the medical department”. We are on the medical department ~~page~~. It is implied.		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.

NaniByte: Undo revision 36685 by NaniByte (talk) ACTUALLY THIS IS A GOOD IDEA!

2023-06-25T17:33:28Z

Undo revision 36685 by NaniByte (talk) ACTUALLY THIS IS A GOOD IDEA!

← Older revision	Revision as of 17:33, 25 June 2023
Line 1:	Line 1:
		{{Under construction
		\|reason = This page is a WIP while I figure out all the details of the new 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, NOT the most comprehensive ones.
		== Issues with the old pages (should be removed once the renovations are done) ==
		The main issue with the old pages style of documentation is that it’s not suited to our type of community. There is too much content. An average of 10 rooms across 10 departments across 5 stations is 500('''!''') required images and text descriptions. This leads to huge swings in quality and huge likelihood that the text/image is outdated.
		== 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.

		All images should be placed in the gallery section. There should be no more than three images of the same type (e.g., medbay storage) in the gallery. The reader does not need to see every variation of the medical storage room. Images of entire departments are to be avoided. Instead, the Maps pages and the Web Map should be linked to, to give the reader a zoomed-out perspective.

		The reader should be informed of the fact that the images are probably outdated, but since the text is not directly connected it should reason that the same should not be assumed of the text. This should give the distinct impression that the images are optional and for just getting the ''general'' idea.
		== 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”. Also, you don’t need to say, for example, “Genetics is in the medical department”. We are on the medical department page. It is implied.

		Room text should contain the following content:
		* Describe any consistent visual features of the room (floor tile color, wall color, signs…)
		* 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.
		* Describe the primary function of the room <u>in general</u>. 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 <u>into detail</u> on what things are used for.

NaniByte: you dum dum this is not a good idea

2023-06-21T18:37:05Z

you dum dum this is not a good idea

← Older revision		Revision as of 18:37, 21 June 2023
Line 1:		Line 1:
	~~{{Under construction~~
	~~\|reason = This page is a WIP while I figure out all the details of the new 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, NOT the most comprehensive ones.
	~~== Issues with the old pages (should be removed once the renovations are done) ==~~
	The main issue with the old pages style of documentation is that it’s not suited to our type of community. There is too much content. An average of 10 rooms across 10 departments across 5 stations is 500('''!''') required images and text descriptions. This leads to huge swings in quality and huge likelihood that the text/image is outdated.
	~~== 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.

	All images should be placed in the gallery section. There should be no more than three images of the same type (e.g., medbay storage) in the gallery. The reader does not need to see every variation of the medical storage room. Images of entire departments are to be avoided. Instead, the Maps pages and the Web Map should be linked to, to give the reader a zoomed-out perspective.

	The reader should be informed of the fact that the images are probably outdated, but since the text is not directly connected it should reason that the same should not be assumed of the text. This should give the distinct impression that the images are optional and for just getting the ''general'' idea.
	~~== 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”. Also, you don’t need to say, for example, “Genetics is in the medical department”. We are on the medical department page. It is implied.

	~~Room text should contain the following content:~~
	* Describe any consistent visual features of the room (floor tile color, wall color, signs…)
	* 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.
	* Describe the primary function of the room <u>in general</u>. 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 <u>into detail</u> on what things are used for.~~

NaniByte: /* New Location Pages Guidelines */ formatting and such

2023-06-12T13:42:45Z

New Location Pages Guidelines: formatting and such

← Older revision		Revision as of 13:42, 12 June 2023
Line 1:		Line 1:
	~~= 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, NOT the most comprehensive ones.
	{{Under construction		{{Under construction
	\|reason = This page is a WIP while I figure out all the details of the new guidelines		\|reason = This page is a WIP while I figure out all the details of the new 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, NOT the most comprehensive ones.
	== Issues with the old pages (should be removed once the renovations are done) ==		== Issues with the old pages (should be removed once the renovations are done) ==
	The main issue with the old pages style of documentation is that it’s not suited to our type of community. There is too much content. An average of 10 rooms across 10 departments across 5 stations is 500('''!''') required images and text descriptions. This leads to huge swings in quality and huge likelihood that the text/image is outdated.		The main issue with the old pages style of documentation is that it’s not suited to our type of community. There is too much content. An average of 10 rooms across 10 departments across 5 stations is 500('''!''') required images and text descriptions. This leads to huge swings in quality and huge likelihood that the text/image is outdated.

	== 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.
Line 14:		Line 12:

	The reader should be informed of the fact that the images are probably outdated, but since the text is not directly connected it should reason that the same should not be assumed of the text. This should give the distinct impression that the images are optional and for just getting the ''general'' idea.		The reader should be informed of the fact that the images are probably outdated, but since the text is not directly connected it should reason that the same should not be assumed of the text. This should give the distinct impression that the images are optional and for just getting the ''general'' idea.

	== 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”. Also, you don’t need to say, for example, “Genetics is in the medical department”. We are on the medical department page. It is implied.		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”. Also, you don’t need to say, for example, “Genetics is in the medical department”. We are on the medical department page. 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 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.
Line 26:		Line 22:
	* Add any station specific differences.		* Add any station specific differences.
	* Add any miscellaneous notes.		* Add any miscellaneous notes.

	The room pages should '''NOT''' explain how things work and should '''NOT''' go <u>into detail</u> on what things are used for.		The room pages should '''NOT''' explain how things work and should '''NOT''' go <u>into detail</u> on what things are used for.

NaniByte: init

2023-06-12T13:42:17Z

init

New page

= 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, NOT the most comprehensive ones.
{{Under construction
|reason = This page is a WIP while I figure out all the details of the new guidelines
}}

== Issues with the old pages (should be removed once the renovations are done) ==
The main issue with the old pages style of documentation is that it’s not suited to our type of community. There is too much content. An average of 10 rooms across 10 departments across 5 stations is 500('''!''') required images and text descriptions. This leads to huge swings in quality and huge likelihood that the text/image is outdated.

== 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 the gallery section. There should be no more than three images of the same type (e.g., medbay storage) in the gallery. The reader does not need to see every variation of the medical storage room. Images of entire departments are to be avoided. Instead, the Maps pages and the Web Map should be linked to, to give the reader a zoomed-out perspective.

The reader should be informed of the fact that the images are probably outdated, but since the text is not directly connected it should reason that the same should not be assumed of the text. This should give the distinct impression that the images are optional and for just getting the ''general'' idea.

== 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”. Also, you don’t need to say, for example, “Genetics is in the medical department”. We are on the medical department page. It is implied.

Room text should contain the following content:

* Describe any consistent visual features 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.