Implemented Coding Contracts

doc/source/codingcontracts.rst

@@ -0,0 +1,47 @@
+.. _codingcontracts:
+
+Coding Contracts
+================
+Coding Contracts are a mechanic that lets players earn rewards in
+exchange for solving programming problems.
+
+Coding Contracts are files with the ".cct" extensions. They can
+be accessed through the :ref:`terminal`  or through scripts using
+the :ref:`netscriptcodingcontractapi`
+
+Each contract has a limited number of attempts. If you
+provide the wrong answer too many times and exceed the
+number of attempts, the contract will self destruct (delete itself)
+
+Currently, Coding Contracts are randomly generated and
+spawned over time. They can appear on any server (including your
+home computer), except for your purchased servers.
+
+
+Running in Terminal
+^^^^^^^^^^^^^^^^^^^
+To run a Coding Contract in the Terminal, simply use the
+:ref:`run_terminal_command` command::
+
+    $ run some-contract.cct
+
+Doing this will bring up a popup. The popup will display
+the contract's problem, the number of attempts remaining, and
+an area to provide an answer.
+
+Interacting through Scripts
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+See :ref:`netscriptcodingcontractapi`.
+
+Rewards
+^^^^^^^
+There are currently four possible rewards for solving a Coding Contract:
+
+* Faction Reputation for a specific Faction
+* Faction Reputation for all Factions that you are a member of
+* Company reputation for a specific Company
+* Money
+
+The 'amount' of reward varies based on the difficulty of the problem
+posed by the Coding Contract. There is no way to know what a
+Coding Contract's exact reward will be until it is solved.