Documentation

[g4v4g4i]

The documentation and readme file on github should be updated.

Edit (daimpi - 16.03.17) tbd for documentation:

• [ ] Merge doc from HSR branch into current development branch: the nice documentation from the HSR branch should be integrated to our current development branch (new-main / master after merge). This probably has to be done manually, as too much has changed in the documentation / the model in the meantime.

• [ ] Integrate current 'wip' section of the infotab: The description of procedures and variables should be integrated into the documentation at the appropriate places after the integration of the HSR doc.

• [ ] Replace the term admissibility with defensibility. As @dunjaseselja remarked:

  btw, just for the program, since in all papers we use the term "defensibility", we shouldn't use "admissibility" for the program/documentation either, but rather "defensibility" everywhere […] cause admissibility is a technical term in argumentation and we don't employ is exactly

• [ ] Replace the term biased (agents) with deceptive. This term better captures the behavior of our researchers in this treatment.

• [ ] Replace within-theory with homogeneous / heterogeneous. We already use those terms in our papers and they seem to better capture the interpretation of these treatments.

The three points above also apply to in-code-comments which should be adjusted accordingly.

[daimpi]

I've edited the original issue to reflect the the things we recently discussed wrt the documentation.