Factorio:Wiki rules
This page is used for contributors on this wiki.
Get an account
Just follow the instructions for registering. It takes normally one or two days to be added, because every user is added by hand to avoid spam.
How to contribute?
This wiki is the work of a team. The wiki is created in an agile process: If someone asks something in the forum, it's a good idea to add it into the forum. No special knowledge is needed for that, just write and if it is ok, it isn't deleted :)
But eventually it will be changed or removed by others.
Don't be afraid: There is nothing, which you can really break, because the wiki has a version history.
Basic
- Read the wiki pages.
- If you don't like something, change it.
- If you find typos, change it.
- If you find something is wrong described, make a prove, that it is wrong and change it.
Advanced
- Add missing information at the right place.
- This is in most cases easy, but sometimes could be really difficult. Ask for help if you don't know.
- Split the information on big pages into subpages.
- See for example the Railway network.
- If you find that a topic belongs to two pages, then don't copy the information into the two pages, but create a new page and link.
- Best example for this is the Power Production page.
- Take the right words.
- Factorio has a set of words, which have a fixed meaning. For example: an entity can be mined, an item can be picked up. Removing them means something different! Ask the factorio wiki, if you are unsure.
- A picture says more than 1000 words.
- Make pictures, if possible. In some case use GIFs! See down.
- You can also go to the Wiki To-do List and look, if there is a job you like.
Discussions
I (ssilk) prefer the forum for discussions and I hope this is not a problem, because I think, discussions on wiki-pages is to high-end for most potential wiki-writers.
Existing discussions
In the descending order of date:
http://www.factorioforums.com/forum/viewtopic.php?f=5&t=2047
http://www.factorioforums.com/forum/viewtopic.php?f=5&t=3205
http://www.factorioforums.com/forum/viewtopic.php?f=5&t=2429
http://www.factorioforums.com/forum/viewtopic.php?f=5&t=2255
Translations
This is currently a mess!
This is how it should work
This method is used by the Mediawiki-Team and we want to adapt it:
First some rules
- The default language is English.
- Any other language has no right to obtain a pagename, which collides with English.
- No other language has the right to use a pagename, which means the same or something different in another language.
This is the logical consequence of the above rules
- Let's say we have a page named Transport network.
- Now someone translate that page to German: Because he doesn't know better, he names the page "Transport netzwerk".
- This is a mess! Because for example in Swedish (it's just an example) this is also the translated pagename.
- What's now right? Is Transport netzwerk now a German or a Swedish page?
Solution to this
The right pagename is Transport network/de for the German and Transport network/sv for the Swedish page.
Whuuaaaa... "Transport network" - that's not German!
Yes, but it is the only way to keep the namespace clean.
And there is nothing about making a redirect page Transport netzwerk which redirects to Transport network/de. Or make a page where the user can choose if he wants the German or Swedish page.
So what do I need to do now?
- If you want to translate a page, then do not rename the page, just add a "/" and the standard macro-language-code to the pagename.
- "Inserters" becomes "Inserters/fr" for France, "Inserters/ru" for Russian etc.
- If you are working on a page, which has a translated pagename then rename (Move) it! Search the orginal pagename, add the language-code (see above) and move it to the new pagename. A redirect is automatically left for the old pagename!
(More to explain, language macro, see main-page at top right)
Pictures
Making pictures out of the game
Do's:
- Take pictures at day! Turn on daylight! Use night or dawn only, if needed to explain something.
- Turn off clouds! The shadows are especially in GIF-animations not useful.
- Steam/smoke is also not so useful.
- Use god mode! Lua/Player#controllertype. You can go to every place and don't stand in the way of the picture.
- You can slowdown the game to find the right moment for the picture. Slowdown is also useful, if you use Gifcam, which makes screenshoot in 30 frames/sec only.
- You can use also the Lua/Game#peacefulmode, to be not disturbed by the natives.
- You can stop the game in the right moment using SHIFT-SPACE key. That also blends the grid in.
- Learn how to use the Debug mode to add relevant information into this picture.
- Go into the highest zoom level you possibly can, without missing any vital information.
Dont's
- Don't make pictures of ultra-complicated stuff! Or only, if you show how that could look in the end. Add only as much elements, which are needed to understand, how that might work.
- Don't just take a screenshot. Try to remove all unneeded informations from the picture.
- Try not to make a picture with the character, except if to should show something; then face the character to it.
See http://www.factorioforums.com/forum/viewtopic.php?f=6&t=2472 for more.
Optimizing the picture before upload
- Cut as much as possible/nice.
- Resolution should not normally be higher than 800x800 px.
- Do not add textual information into the pictures! Instead add numbers or letters in it and add the text on the wiki-page; otherwise, it isn't searchable information.
- Sharpen the pictures. For the wiki it looks quite better to sharpen the pictures one ore two times.
Making animations
This has to be tested a bit:
- Gifcam (PC only)
- Licecap (also for Mac)
- Good example pictures: http://www.factorioforums.com/forum/viewtopic.php?f=5&t=3920
In-game API for screenshots
http://www.factorioforums.com/forum/viewtopic.php?f=25&t=4109#p30605
Looks like a plan: create a world. Walk through the world. Start a replay of this walk and then add making screenshots.
More or less like the method used in the demo-video, but take only some gif-animations or single pictures.