DSP Wiki:Plan - Revision history

imported>76561198018895007: /* Templates */

2021-02-16T05:18:23Z

Templates

← Older revision		Revision as of 05:18, 16 February 2021
Line 38:		Line 38:
	* We want to avoid having a billion highly specialized templates, but not at the expense of usefulness and ease of maintaining a unified wiki.		* We want to avoid having a billion highly specialized templates, but not at the expense of usefulness and ease of maintaining a unified wiki.
	* Extension:TemplateStyles is installed, activated, and in use on many templates already. Please put any template-styling in a subpage named "style.css", and ensure that it is saved in the "Sanitized CSS" Content Model, or it will not load correctly. While in this content model, CodeEditor will be the default editor for editing the stylesheet. If you find yourself unable to save the page after an edit, it is because of invalid or unsafe CSS. Unfortunately at this time, no error message is provided to say what is wrong.		* Extension:TemplateStyles is installed, activated, and in use on many templates already. Please put any template-styling in a subpage named "style.css", and ensure that it is saved in the "Sanitized CSS" Content Model, or it will not load correctly. While in this content model, CodeEditor will be the default editor for editing the stylesheet. If you find yourself unable to save the page after an edit, it is because of invalid or unsafe CSS. Unfortunately at this time, no error message is provided to say what is wrong.

			UPDATE: As of 2/15/2021, The editing of Templates is now restricted to sysop (highest level admin) only. This is to prevent the wholesale changes of the structure of the templates that is used by automated scripts to keep game information updated. If you need a template created or revised, join the wiki's Discord and put it in #wiki-requests.

	==Categories==		==Categories==

imported>76561198048978957: /* Templates */ Just capitalized the first word "We" in the second bullet.

2021-01-29T04:36:48Z

Templates: Just capitalized the first word "We" in the second bullet.

← Older revision		Revision as of 04:36, 29 January 2021
Line 36:		Line 36:
	==Templates==		==Templates==
	* We are evaluating templates from other wikis for import to DSP Wiki. Templates are quite a big beast to tackle, as many rely on other templates or LUA modules and just importing one could result in requiring dozens more. Each required one must be evaluated for whether it is needed on our Wiki. If you have a desire for a template to do something, file a [[DSP_Wiki:Requests\|request]] and we'll look into it. If you're experienced with MediaWiki Template creation, this is an area we can use a lot of help!		* We are evaluating templates from other wikis for import to DSP Wiki. Templates are quite a big beast to tackle, as many rely on other templates or LUA modules and just importing one could result in requiring dozens more. Each required one must be evaluated for whether it is needed on our Wiki. If you have a desire for a template to do something, file a [[DSP_Wiki:Requests\|request]] and we'll look into it. If you're experienced with MediaWiki Template creation, this is an area we can use a lot of help!
	* we want to avoid having a billion highly specialized templates, but not at the expense of usefulness and ease of maintaining a unified wiki.		* We want to avoid having a billion highly specialized templates, but not at the expense of usefulness and ease of maintaining a unified wiki.
	* Extension:TemplateStyles is installed, activated, and in use on many templates already. Please put any template-styling in a subpage named "style.css", and ensure that it is saved in the "Sanitized CSS" Content Model, or it will not load correctly. While in this content model, CodeEditor will be the default editor for editing the stylesheet. If you find yourself unable to save the page after an edit, it is because of invalid or unsafe CSS. Unfortunately at this time, no error message is provided to say what is wrong.		* Extension:TemplateStyles is installed, activated, and in use on many templates already. Please put any template-styling in a subpage named "style.css", and ensure that it is saved in the "Sanitized CSS" Content Model, or it will not load correctly. While in this content model, CodeEditor will be the default editor for editing the stylesheet. If you find yourself unable to save the page after an edit, it is because of invalid or unsafe CSS. Unfortunately at this time, no error message is provided to say what is wrong.

imported>76561198018895007 at 02:36, 29 January 2021

2021-01-29T02:36:58Z

← Older revision		Revision as of 02:36, 29 January 2021
Line 12:		Line 12:
	===Cards===		===Cards===
	We are working on using "cards" (to borrow the term from Bootstrap) to compartmentalize information. For example, the front page will have a Card for each main category (Gameplay, Items, Technologies, etc.) and each will have a brief text description and link either to the Category page for that topic, or an actual page, depending. The category pages will then have Cards breaking them down similarly, etc. Cards will be created using Templates to make things easier, but for now, adding information to pages without the use of cards is acceptable.		We are working on using "cards" (to borrow the term from Bootstrap) to compartmentalize information. For example, the front page will have a Card for each main category (Gameplay, Items, Technologies, etc.) and each will have a brief text description and link either to the Category page for that topic, or an actual page, depending. The category pages will then have Cards breaking them down similarly, etc. Cards will be created using Templates to make things easier, but for now, adding information to pages without the use of cards is acceptable.

			===Mobile===
			Our mobile support currently is "barely implemented". We're aware of some things that are thoroughly broken such as randomly wrong-sized images, invisible icons, etc. Putting effort into fixing these for the current mobile skin detracts from time spent writing the real skin, so we're only fixing Mobile issues that completely break the site for users, at this time. Stay with us, we'll get there!


	==Images==		==Images==

imported>76561198018895007 at 02:33, 29 January 2021

2021-01-29T02:33:48Z

← Older revision		Revision as of 02:33, 29 January 2021
Line 1:		Line 1:
	=The Plan=

	Here, we will attempt to outline the overall plan for DSP Wiki		Here, we will attempt to outline the overall plan for DSP Wiki

imported>76561198018895007 at 02:33, 29 January 2021

2021-01-29T02:33:01Z

← Older revision		Revision as of 02:33, 29 January 2021
Line 5:		Line 5:
	==UI/UX==		==UI/UX==
	The aim for the UI/UX (aka "Skin" in Mediawiki terms, "Theme" is another good word) is to be as similar to the in-game UI as possible. In particular:		The aim for the UI/UX (aka "Skin" in Mediawiki terms, "Theme" is another good word) is to be as similar to the in-game UI as possible. In particular:
	* Color scheme: "Dark" theme, colors shifted to match game colors (light blue #d1ffff and/or orange #f3a602). The currently used orange theme is NOT the final product, it is borrowed from another wiki.		* Color scheme: "Dark" theme, colors shifted to match game colors (light blue #d1ffff and/or orange #f3a602). The currently used orange theme is NOT the final product, it is borrowed from another wiki until we can get the Skin written - this is not a small task!
	* The page content area will be transitioned to look similar to the various windows in the game. Goal is to replicate the Inventory window, with the upper-left "folder tab" housing the page title, and the upper-right "close window" area being replaced by page status/notification icons, and action links. The CSS for this is tricky, but work is ongoing.		* The page content area will be transitioned to look similar to the various windows in the game. Goal is to replicate the Inventory window, with the upper-left "folder tab" housing the page title, and the upper-right "sort / close window" area being replaced by page status/notification icons, and action links. The CSS for this is tricky, but work is ongoing.
	* ~~Considering~~ using in-game mouse cursor as ~~well~~		* We are also considering using the in-game mouse cursor, but have not reached a decision.
	* DO NOT apply excessive CSS in-line or in-page unless it is absolutely necessary. Especially try to avoid overriding site-wide CSS, except for special circumstances. Doing so makes it incredibly difficult to go back and update the Skin when necessary. This especially applies to background colors.		* Please DO NOT apply excessive CSS in-line or in-page unless it is absolutely necessary. Especially try to avoid overriding site-wide CSS, except for special circumstances. Doing so makes it incredibly difficult to go back and update the Skin when necessary. This especially applies to background colors.
	* Templates should be used for most CSS overrides, when possible. This allows us to make the change in one place, and affect all instances.		* Templates should be used for most CSS overrides, when possible. This allows us to make the change in one place, and affect all instances. For some additional information, see the Templates section below.


	===Cards===		===Cards===
	We are working on using "cards" to compartmentalize information. For example, the front page will have a Card for each main category (Gameplay, Items, Technologies, etc.) and each will have a brief text description and link either to the Category page for that topic, or an actual page, depending. The category pages will then have Cards breaking them down similarly, etc. Cards will be created using Templates to make things easier, but for now, adding information to pages without the use of cards is acceptable.		We are working on using "cards" (to borrow the term from Bootstrap) to compartmentalize information. For example, the front page will have a Card for each main category (Gameplay, Items, Technologies, etc.) and each will have a brief text description and link either to the Category page for that topic, or an actual page, depending. The category pages will then have Cards breaking them down similarly, etc. Cards will be created using Templates to make things easier, but for now, adding information to pages without the use of cards is acceptable.

	==Images==		==Images==
	* Until after the game officially launches into Early Access on Steam, please do not upload any images from within the game. There is a process in place that will import a lot of images shortly after game launch, which have been prepared in advance for the highest quality possible. That process will break if an image already exists with the same name.
	* Images should be the highest quality possible, and lowest file size obtainable. Different formats apply for different purposes. JPG is best for images with a lot of color transitions, e.g. screenshots of the game itself. PNG works best for simpler images with areas of solid color, and for transparent backgrounds.		* Images should be the highest quality possible, and lowest file size obtainable. Different formats apply for different purposes. JPG is best for images with a lot of color transitions, e.g. screenshots of the game itself. PNG works best for simpler images with areas of solid color, and for transparent backgrounds.
			* DSP Wiki has conditional approval to utilize game assets for display purposes. To maintain these conditions, DO NOT upload game assets that are not released in the vanilla (un-modded) game. If it can't be found in-game, it should not be on DSP Wiki.
	* Whenever possible, images such as icons or other elements of UI, should have transparent backgrounds. This allows them to be layered on other elements and to adapt to potential changes in the Wiki color scheme.		* Whenever possible, images such as icons or other elements of UI, should have transparent backgrounds. This allows them to be layered on other elements and to adapt to potential changes in the Wiki color scheme.
	* Use full words in image names, but keep them as short as possible. It should ultimately be easy to both search for an image, and understand what it is, based on the name.<br>		* Use full words in image names, but keep them as short as possible. It should ultimately be easy to both search for an image, and understand what it is, based on the name.<br>
Line 23:		Line 23:
	::* Nondescriptive: Untitled1.png		::* Nondescriptive: Untitled1.png
	::* Too long: That_one_time_I_flew_too_close_to_a_black_hole.jpg		::* Too long: That_one_time_I_flew_too_close_to_a_black_hole.jpg
	::* About right: ~~Icon_Assembler_Mk1~~.png		::* About right: Icon_Assembler_Mk.1.png

	==Pages==		==Pages==
Line 29:		Line 29:
	* At first, there will be many pages marked "Stub". These are put in place merely to start mapping out the wiki and giving others a starting point. These pages may contain instructions within them of how they are envisioned to be used.		* At first, there will be many pages marked "Stub". These are put in place merely to start mapping out the wiki and giving others a starting point. These pages may contain instructions within them of how they are envisioned to be used.
	**You can use the {{t\|Stub}} template to mark a page as Stub.		**You can use the {{t\|Stub}} template to mark a page as Stub.
	* If you plan to add a great deal of content to a page, please be sure to mark it as {{t\|WIP}}. ~~Moving~~ it to a ~~User/Sandbox~~ page is ~~optional~~, ~~but~~ ~~encouraged~~.		* If you plan to add a great deal of content to a page, please be sure to mark it as {{t\|WIP}}. It is optional but encouraged to copy the page to a user sandbox page for working on it, then copying the completed version back.
	* ~~Every~~ ~~item,~~ ~~technology,~~ ~~upgrade~~, etc. should get its own page. This helps them show up when Searching the wiki, as ~~well~~ as on ~~Google~~ ~~when~~ it ~~indexes~~ ~~the~~ ~~Wiki~~.		* While it's perfectly fine to create Collector pages for things such as Items, every item/technology/upgrade/etc. should get its own page. This helps them show up when Searching the wiki, either via the Wiki's own search engine or via Google.

	==Templates==		==Templates==
	* We are evaluating templates from other wikis for import to DSP Wiki. Templates are quite a big beast to tackle, as many rely on other templates or LUA modules and just importing one could result in requiring dozens more. Each required one must be evaluated for whether it is needed on our Wiki. If you have a desire for a template to do something, file a [[DSP_Wiki:Requests\|request]] and we'll look into it. If you're experienced with MediaWiki Template creation, this is an area we can use a lot of help!		* We are evaluating templates from other wikis for import to DSP Wiki. Templates are quite a big beast to tackle, as many rely on other templates or LUA modules and just importing one could result in requiring dozens more. Each required one must be evaluated for whether it is needed on our Wiki. If you have a desire for a template to do something, file a [[DSP_Wiki:Requests\|request]] and we'll look into it. If you're experienced with MediaWiki Template creation, this is an area we can use a lot of help!
	* we want to avoid having a billion highly specialized templates, but not at the expense of usefulness and ease of maintaining a unified wiki.		* we want to avoid having a billion highly specialized templates, but not at the expense of usefulness and ease of maintaining a unified wiki.
			* Extension:TemplateStyles is installed, activated, and in use on many templates already. Please put any template-styling in a subpage named "style.css", and ensure that it is saved in the "Sanitized CSS" Content Model, or it will not load correctly. While in this content model, CodeEditor will be the default editor for editing the stylesheet. If you find yourself unable to save the page after an edit, it is because of invalid or unsafe CSS. Unfortunately at this time, no error message is provided to say what is wrong.

	==Categories==		==Categories==

imported>76561198018895007: /* Images */

2021-01-11T19:20:55Z

Images

← Older revision		Revision as of 19:20, 11 January 2021
Line 19:		Line 19:
	* Images should be the highest quality possible, and lowest file size obtainable. Different formats apply for different purposes. JPG is best for images with a lot of color transitions, e.g. screenshots of the game itself. PNG works best for simpler images with areas of solid color, and for transparent backgrounds.		* Images should be the highest quality possible, and lowest file size obtainable. Different formats apply for different purposes. JPG is best for images with a lot of color transitions, e.g. screenshots of the game itself. PNG works best for simpler images with areas of solid color, and for transparent backgrounds.
	* Whenever possible, images such as icons or other elements of UI, should have transparent backgrounds. This allows them to be layered on other elements and to adapt to potential changes in the Wiki color scheme.		* Whenever possible, images such as icons or other elements of UI, should have transparent backgrounds. This allows them to be layered on other elements and to adapt to potential changes in the Wiki color scheme.
			* Use full words in image names, but keep them as short as possible. It should ultimately be easy to both search for an image, and understand what it is, based on the name.<br>
			::For example:
			::* Nondescriptive: Untitled1.png
			::* Too long: That_one_time_I_flew_too_close_to_a_black_hole.jpg
			::* About right: Icon_Assembler_Mk1.png

	==Pages==		==Pages==

imported>76561198018895007: /* Images */

2021-01-11T19:17:26Z

Images

← Older revision		Revision as of 19:17, 11 January 2021
Line 16:		Line 16:

	==Images==		==Images==
	* Until after the game officially launches into Early Access on Steam, please do not upload any images from in the game. There is a process in place that will import a lot of images shortly after launch, which have been prepared in advance for the highest quality possible. That process will break if an image already exists with the same name.		* Until after the game officially launches into Early Access on Steam, please do not upload any images from within the game. There is a process in place that will import a lot of images shortly after game launch, which have been prepared in advance for the highest quality possible. That process will break if an image already exists with the same name.
	* Images should be the highest quality possible, and lowest file size obtainable. Different formats apply for different purposes. JPG is best for images with a lot of color transitions, e.g. screenshots of the game itself. PNG works best for simpler images with areas of solid color, and for transparent backgrounds.		* Images should be the highest quality possible, and lowest file size obtainable. Different formats apply for different purposes. JPG is best for images with a lot of color transitions, e.g. screenshots of the game itself. PNG works best for simpler images with areas of solid color, and for transparent backgrounds.
	* Whenever possible, images such as icons or other elements of UI, should have transparent backgrounds. This allows them to be layered on other elements and to adapt to potential changes in the Wiki color scheme.		* Whenever possible, images such as icons or other elements of UI, should have transparent backgrounds. This allows them to be layered on other elements and to adapt to potential changes in the Wiki color scheme.

imported>76561198018895007: /* Cards */

2021-01-11T19:16:50Z

Cards

← Older revision		Revision as of 19:16, 11 January 2021
Line 13:		Line 13:

	===Cards===		===Cards===
	We are ~~moving~~ ~~hard toward the idea of~~ using "cards" to compartmentalize information. For example, the front page will have a Card for each main category (Gameplay, Items, Technologies, etc.) and each will have a brief text description and link either to the Category page for that topic, or an actual page, depending. The category pages will then have Cards breaking them down similarly, etc.		We are working on using "cards" to compartmentalize information. For example, the front page will have a Card for each main category (Gameplay, Items, Technologies, etc.) and each will have a brief text description and link either to the Category page for that topic, or an actual page, depending. The category pages will then have Cards breaking them down similarly, etc. Cards will be created using Templates to make things easier, but for now, adding information to pages without the use of cards is acceptable.


	==Images==		==Images==

imported>76561198018895007: Created page with "=The Plan= Here, we will attempt to outline the overall plan for DSP Wiki ==UI/UX== The aim for the UI/UX (aka "Skin" in Mediawiki terms, "Theme" is another good word) is to..."

2021-01-11T19:03:50Z

Created page with "=The Plan= Here, we will attempt to outline the overall plan for DSP Wiki ==UI/UX== The aim for the UI/UX (aka "Skin" in Mediawiki terms, "Theme" is another good word) is to..."

New page

=The Plan=

Here, we will attempt to outline the overall plan for DSP Wiki

==UI/UX==
The aim for the UI/UX (aka "Skin" in Mediawiki terms, "Theme" is another good word) is to be as similar to the in-game UI as possible. In particular:
* Color scheme: "Dark" theme, colors shifted to match game colors (light blue #d1ffff and/or orange #f3a602). The currently used orange theme is NOT the final product, it is borrowed from another wiki.
* The page content area will be transitioned to look similar to the various windows in the game. Goal is to replicate the Inventory window, with the upper-left "folder tab" housing the page title, and the upper-right "close window" area being replaced by page status/notification icons, and action links. The CSS for this is tricky, but work is ongoing.
* Considering using in-game mouse cursor as well
* DO NOT apply excessive CSS in-line or in-page unless it is absolutely necessary. Especially try to avoid overriding site-wide CSS, except for special circumstances. Doing so makes it incredibly difficult to go back and update the Skin when necessary. This especially applies to background colors.
* Templates should be used for most CSS overrides, when possible. This allows us to make the change in one place, and affect all instances.

===Cards===
We are moving hard toward the idea of using "cards" to compartmentalize information. For example, the front page will have a Card for each main category (Gameplay, Items, Technologies, etc.) and each will have a brief text description and link either to the Category page for that topic, or an actual page, depending. The category pages will then have Cards breaking them down similarly, etc.

==Images==
* Until after the game officially launches into Early Access on Steam, please do not upload any images from in the game. There is a process in place that will import a lot of images shortly after launch, which have been prepared in advance for the highest quality possible. That process will break if an image already exists with the same name.
* Images should be the highest quality possible, and lowest file size obtainable. Different formats apply for different purposes. JPG is best for images with a lot of color transitions, e.g. screenshots of the game itself. PNG works best for simpler images with areas of solid color, and for transparent backgrounds.
* Whenever possible, images such as icons or other elements of UI, should have transparent backgrounds. This allows them to be layered on other elements and to adapt to potential changes in the Wiki color scheme.

==Pages==
* If you think it deserves its own page, you're probably right. Go ahead and create a page, we can merge it elsewhere later on if needed.
* At first, there will be many pages marked "Stub". These are put in place merely to start mapping out the wiki and giving others a starting point. These pages may contain instructions within them of how they are envisioned to be used.
**You can use the {{t|Stub}} template to mark a page as Stub.
* If you plan to add a great deal of content to a page, please be sure to mark it as {{t|WIP}}. Moving it to a User/Sandbox page is optional, but encouraged.
* Every item, technology, upgrade, etc. should get its own page. This helps them show up when Searching the wiki, as well as on Google when it indexes the Wiki.

==Templates==
* We are evaluating templates from other wikis for import to DSP Wiki. Templates are quite a big beast to tackle, as many rely on other templates or LUA modules and just importing one could result in requiring dozens more. Each required one must be evaluated for whether it is needed on our Wiki. If you have a desire for a template to do something, file a [[DSP_Wiki:Requests|request]] and we'll look into it. If you're experienced with MediaWiki Template creation, this is an area we can use a lot of help!
* we want to avoid having a billion highly specialized templates, but not at the expense of usefulness and ease of maintaining a unified wiki.

==Categories==
* A wiki of this type doesn't require a great deal of categories, but we'd like to sub-categorize as much as possible. For example, the "Items" Category should ultimately contain all items available in the game, but as with the game, it should be sub-categorized ''at least'' to "Buildings" and "Components", and possibly even further, such as "Assemblers" "Resource Extractors" and "Logistics" under buildings, etc.
* Remember to add a brief description to new categories, so that they get a page and don't show as a broken link
* Ultimately, Categories should be intuitive to the average game player, and follow a logical path - see "Cards" under "UI/UX" for more on why.