docs: Add Village

Author: oliversalzburg

packages/documentation/docs/sections/bonfire.md

@@ -10,10 +10,16 @@ When you enable a building, this building will be built if all of these are true
 
 ### Upgrades
 
-Buildings with a "⮤" in front of their name are upgrades to the building above them.
+Buildings with a `⮤` in front of their name are upgrades to the building above them.
 
 You can select which upgrade will be automatically purchased by enabling them under **Upgrade buildings**.
 
-## Additional options
+## Additional Options
 
-**Turn on steamworks** turns on the Steamworks building as soon as the first one is purchased.
+### Turn on Steamworks
+
+Turns on the Steamworks building as soon as the first one is purchased, and keeps them turned on.
+
+### Turn on Magnetos
+
+Turns on the Magnets building as soon as the first one is purchased, and keeps them turned on.

packages/documentation/docs/sections/village.md

@@ -1 +1,29 @@
 # Village
+
+## Jobs
+
+The top section lets you control how to automatically assign free kittens to jobs.
+
+Free kittens will be assigned to all enabled jobs until their respective **Max** is reached. Kittens are distributed one by one over time. Whichever job has the lowest amount of kittens assigned, will be assigned the next free kitten.
+
+## Additional Options
+
+### Hunt
+
+Sends your hunters on a hunt, when your catpower has reached **Trigger** of its capacity.
+
+### Hold Festivals
+
+Holds festivals whenever they are considered profitable. A festival is considered profitable if all of the spent resources are regained over the period of the festival.
+
+### Promote Kittens
+
+Promotes your kittens, when your gold has reached **Trigger** of its capacity. Kittens are promoted if you have engineers that would profit from having a higher rank. Otherwise, high ranks are meaningless.
+
+### Promote Leader
+
+Promotes your leader, as soon as possible.
+
+### Elect leader
+
+Elects a kittens with the given attributes as a leader.

packages/userscript/source/VillageManager.ts

@@ -157,7 +157,7 @@ export class VillageManager implements Automation {
       let tier = -1;
       const engineerSpeciality =
         this._host.gamePage.village.sim.kittens[kittenIndex].engineerSpeciality;
-      // If this kitten has no engineer speciality, skip it.
+      // If this kitten has no engineer specialty, skip it.
       if (isNil(engineerSpeciality)) {
         continue;
       }