From 30259bbce4eb3a3845ca0a9652b375ac5bccab82 Mon Sep 17 00:00:00 2001 From: NickKolok Date: Wed, 29 Jun 2022 15:28:33 +0300 Subject: [PATCH 1/5] Chair's Manual - an empty page --- .../IPTdev/templates/IPTdev/chairs_manual.html | 14 ++++++++++++++ ipt_connect/IPTdev/urls.py | 1 + ipt_connect/IPTdev/views.py | 10 ++++++++++ 3 files changed, 25 insertions(+) create mode 100644 ipt_connect/IPTdev/templates/IPTdev/chairs_manual.html diff --git a/ipt_connect/IPTdev/templates/IPTdev/chairs_manual.html b/ipt_connect/IPTdev/templates/IPTdev/chairs_manual.html new file mode 100644 index 0000000..25d8a32 --- /dev/null +++ b/ipt_connect/IPTdev/templates/IPTdev/chairs_manual.html @@ -0,0 +1,14 @@ +{% extends params.instance_name|add:'/head.html' %} +{% load i18n %} + +{% block content %} + + +
+

+ {% trans 'Chair\'s Manual' %} +

+
+ + +{% endblock content %} diff --git a/ipt_connect/IPTdev/urls.py b/ipt_connect/IPTdev/urls.py index 460b5a6..f17c9dd 100644 --- a/ipt_connect/IPTdev/urls.py +++ b/ipt_connect/IPTdev/urls.py @@ -50,4 +50,5 @@ url(r"^verify_all", verify_all, name="verify_all"), url(r"^upload_csv", upload_csv, name="upload_csv"), url(r"^upload_problems", upload_problems, name="upload_problems"), + url(r"^chairs_manual", chairs_manual, name="chairs_manual"), ] diff --git a/ipt_connect/IPTdev/views.py b/ipt_connect/IPTdev/views.py index 29a106a..3e8680a 100644 --- a/ipt_connect/IPTdev/views.py +++ b/ipt_connect/IPTdev/views.py @@ -1091,3 +1091,13 @@ def upload_problems(request): 'params': params, } ) + +@cache_page(cache_duration) +def chairs_manual(request): + return render( + request, + '%s/chairs_manual.html' % params.instance_name, + { + 'params': params, + } + ) From 3fcc60b5559159aaf4aa908065c1b9634df08d04 Mon Sep 17 00:00:00 2001 From: NickKolok Date: Fri, 1 Jul 2022 00:28:04 +0300 Subject: [PATCH 2/5] [docs] All the links in the Chair's Manual should open in a new tab --- .../templates/IPTdev/chairs_manual.html | 92 +++++++++++++++++++ ipt_connect/IPTdev/urls.py | 2 +- 2 files changed, 93 insertions(+), 1 deletion(-) diff --git a/ipt_connect/IPTdev/templates/IPTdev/chairs_manual.html b/ipt_connect/IPTdev/templates/IPTdev/chairs_manual.html index 25d8a32..de0baf1 100644 --- a/ipt_connect/IPTdev/templates/IPTdev/chairs_manual.html +++ b/ipt_connect/IPTdev/templates/IPTdev/chairs_manual.html @@ -3,6 +3,7 @@ {% block content %} +

@@ -11,4 +12,95 @@

+
+

+ {% trans 'Chairs must have access to ipt-connect to fill it out with the information about each round.' %} + {% trans 'Info includes all presenters, all jurors and their grades, problems presented and rejected.' %} + + {% trans 'ipt-connect is the main source of the fight info to be verified afterwards and used to resolve the issues.' %} + {% trans 'So, pay attention to making all records in timely and accurate fashion.' %} + +

+ +

+ + {% trans 'There probaly is no public link to this page (at least at the top menu), so you should have obtained the link somehow :)' %} + +

+ + +

+ {% trans 'Signing in' %} +

+ {% trans 'The login page is probably located' %} + + here. + {% trans 'You should have obtained your credentials (the login and the password) from the Organizing Committee in advance.' %} + {% trans 'Probably, the ones from the previous year/tournament (if any) are OK.' %} + {% trans 'Also, you should be reminded to check the credentials.' %} + {% trans 'If you haven\'t checked the ability to log in and the visibility of the touranment, just do it right now!' %} + + +

+ {% trans 'Before every fight' %} +

+ + {% trans '(including the first but probably not the Final)' %} + +
    +
  • +

    + {% trans 'Introduce ipt_connect to the participants' %} +

    + {% trans 'You should probably emphasize that ipt_connect is a Free Software.' %} +
    • +
  • +

    + {% trans 'Show how to use' %} + + {% trans 'the Tactics Builder' %} + +

    + {% trans 'The link to it can be found' %} + + {% trans 'on the main page' %}. + {% trans 'It looks like a good idea to use the Tactics Builder on the stage to obtain the list of permitted Problems.' %} + {% trans 'It seems to make sense to present the Tactics Builder on the first fight, so that the participants will be able to use it between the first and the second fights.' %} + {% trans 'All in all, our Tournament is about scientific discussions, and not about striking out digits on a sheet of paper fastly and precisely!' %} +
    • +
  • +

    + {% trans 'Encourage participants, team-leaders and jurors to double-check the results and share bugs and ideas' %} +

    +
    • +
+

+ {% trans 'After every fight' %} +

+ + {% trans '(that is, after all scores have been submitted and all rounds have been filled out)' %} + + + +
+ {% endblock content %} diff --git a/ipt_connect/IPTdev/urls.py b/ipt_connect/IPTdev/urls.py index f17c9dd..edb88db 100644 --- a/ipt_connect/IPTdev/urls.py +++ b/ipt_connect/IPTdev/urls.py @@ -35,7 +35,7 @@ name="physics_fight_detail", ), url(r"^ranking$", ranking, name="ranking"), - url(r"^build_tactics$", build_tactics), + url(r"^build_tactics$", build_tactics, name="build_tactics"), url(r"^poolranking$", poolranking, name="poolranking"), url(r"^export_csv_ranking_timeline$", export_csv_ranking_timeline), url(r"^participants_export$", participants_export), From 654dca305a88407e6e4a2ec3ea6b0a27346b036c Mon Sep 17 00:00:00 2001 From: NickKolok Date: Fri, 1 Jul 2022 00:30:03 +0300 Subject: [PATCH 3/5] [docs] Underline all the important links in Chair's Manual --- .../IPTdev/templates/IPTdev/chairs_manual.html | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/ipt_connect/IPTdev/templates/IPTdev/chairs_manual.html b/ipt_connect/IPTdev/templates/IPTdev/chairs_manual.html index de0baf1..4b55542 100644 --- a/ipt_connect/IPTdev/templates/IPTdev/chairs_manual.html +++ b/ipt_connect/IPTdev/templates/IPTdev/chairs_manual.html @@ -12,7 +12,13 @@

-
+ + +

{% trans 'Chairs must have access to ipt-connect to fill it out with the information about each round.' %} {% trans 'Info includes all presenters, all jurors and their grades, problems presented and rejected.' %} @@ -20,6 +26,10 @@

{% trans 'ipt-connect is the main source of the fight info to be verified afterwards and used to resolve the issues.' %} {% trans 'So, pay attention to making all records in timely and accurate fashion.' %} + {% trans 'Links in this Manual are underlined and usually lead to appropriate pages for ' %} + + {{params.instance_name}}. + {% trans 'If you are going to work with another tournament, switch to it somehow or don\'t lean onto the underlined links at all.' %}

From e45b563310c8f0cfc840541214a03f8f81cebd65 Mon Sep 17 00:00:00 2001 From: NickKolok Date: Fri, 1 Jul 2022 00:30:39 +0300 Subject: [PATCH 4/5] [docs] Chair's Manual - describe the verificator --- .../IPTdev/templates/IPTdev/chairs_manual.html | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/ipt_connect/IPTdev/templates/IPTdev/chairs_manual.html b/ipt_connect/IPTdev/templates/IPTdev/chairs_manual.html index 4b55542..c08b5fc 100644 --- a/ipt_connect/IPTdev/templates/IPTdev/chairs_manual.html +++ b/ipt_connect/IPTdev/templates/IPTdev/chairs_manual.html @@ -106,8 +106,20 @@

{% trans 'Pool Ranking' %} - {% trans '(the latter if the pools are enabled)' %}. + {% trans 'pages (the latter if the pools are enabled)' %}. {% trans 'You should have appropriate rights to run this tool (obviously, any superuser has).' %} + {% trans 'Updating of the scores can take a few minutes, especially after the last fights.' %} + +
  • +

    + {% trans 'Verify all the data' %} +

    + {% trans 'The verification report is located' %} + + {% trans 'here' %}. + {% trans 'You should have the same rights to run this tool.' %} + {% trans 'The tool covers many widespread errors (e.g. forgotten Problem presented), but don\'t lean onto it entirely; be careful!' %} + {% trans 'In case of having any ideas to improve the tool, contact us.' %}
    • From a8eb39d138a54db3d37220f4b0b736b0275e3214 Mon Sep 17 00:00:00 2001 From: NickKolok Date: Fri, 1 Jul 2022 01:34:03 +0300 Subject: [PATCH 5/5] [docs] Chair's Manual - After the Final --- .../templates/IPTdev/chairs_manual.html | 51 +++++++++++++++++++ 1 file changed, 51 insertions(+) diff --git a/ipt_connect/IPTdev/templates/IPTdev/chairs_manual.html b/ipt_connect/IPTdev/templates/IPTdev/chairs_manual.html index c08b5fc..cc6cf23 100644 --- a/ipt_connect/IPTdev/templates/IPTdev/chairs_manual.html +++ b/ipt_connect/IPTdev/templates/IPTdev/chairs_manual.html @@ -123,6 +123,57 @@

    +

    + {% trans 'After the Final' %} +

    +
      +
    • +

      + + {% trans 'Update all the grades' %} + + {% trans '(just in case)' %} +

      +
      • +
    • +

      + {% trans 'Double-check the Final grades' %} +

      +
      • +
    • +

      + + {% trans 'Verify all the grades' %} + +

      +
      • +
    • +

      + {% trans 'If you want to hide the results, switch ipt_connect into maintenance mode via' %} + + {% trans 'Site Configuration' %} + {% trans '("Only staff access").' %} +

      + {% trans 'Be careful: anybody who has an ipt_connect credentials can see the grades!' %} + {% trans 'If ipt_connect is used for registration (which is not recommended),' %} + {% trans 'all the Team Leaders have credentials and can see through The Blue Balls.' %} + {% trans 'Then disable (probably without removal) the Team Leaders\' logins at' %} + + {% trans 'Users Admin Panel' %}. + {% trans '(You need appropriate rights to change Users; a superuser has them.)' %} +
      + TODO: images! Site Config and the result +
      • +
    • +

      + {% trans 'Enable "Display link to final on ranking page" and "Display final ranking on ranking page" checkboxes in' %} + + {% trans 'Site Configuration' %} + {% trans 'if you wish.' %} +

      + TODO: images! Site Config and the result +
      • +

    {% endblock content %}