From 7e918d834296e206aef922ee02d6991722c4653e Mon Sep 17 00:00:00 2001 From: Timotej Lazar Date: Thu, 8 Oct 2015 16:15:24 +0200 Subject: Add readme --- readme.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 readme.md diff --git a/readme.md b/readme.md new file mode 100644 index 0000000..ec26acd --- /dev/null +++ b/readme.md @@ -0,0 +1,28 @@ +The file hierarchy for problem data is below. Comments indicate the global +variables and functions that can be defined in each file. Only the ID is +necessary. See existing problems for examples. + + +├── common.py # id, hint_type, hint() [language-specific] +├── en.py # name, description, hint [language-specific] +├── sl.py # name, description, hint [language-specific] +└── problems +    └── + ├── common.py # id, number + ├── en.py # name, description + ├── sl.py # name, description +    └── +       ├── common.py # id, number, test(), hint_type, hint() [problem-specific] +       ├── en.py # name, plan, hint [problem-specific] +       └── sl.py # name, plan, hint [problem-specific] + +To add a problem, create the necessary files. Pick an unused problem ID from +the relevant range below: + + Prolog: 10000-19999 + Python: 20000-29999 + Robot: 30000-39999 + +Running scripts/build_web_resources.py in the codeq-server repo will generate +JSON files for all problems, and insert new problems, groups and languages in +the database. -- cgit v1.2.1