-
Notifications
You must be signed in to change notification settings - Fork 278
Document team boxes #3176
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Document team boxes #3176
Conversation
|
|
||
| - all attachments such as 'testing tools' to problems, | ||
| - view the submission and acceptance ratio during the contest as an indicator of the difficulty of a problem, | ||
| - get the problem statement and clarifications on those statements |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Either add a comma at the end here or remove it from the first two lines.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I went with the extra comma.
doc/manual/team.rst
Outdated
| Use the |problemseturlteam| page to get: | ||
|
|
||
| - all attachments such as 'testing tools' to problems, | ||
| - view the submission and acceptance ratio during the contest as an indicator of the difficulty of a problem, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I like the brevity of this explanation, but I'm not sure if we might want to include a hint that more information is available when hovering the indicators.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Feel free to propose an alternative text.
doc/manual/substitutions.dist.py
Outdated
| .. |DOMjudge| replace:: DOMjudge | ||
| .. |baseurlteam| replace:: https://example.com/domjudge/team | ||
| .. |problemseturlteam| replace:: https://example.com/domjudge/team/problems |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Do we need to mention the URL? It's in the menu, nobody should need to enter more than the base URL anyway.
doc/manual/substitutions.py.in
Outdated
| .. |PROCLIMIT| replace:: 64 | ||
|
|
||
| """ % (baseurl_separator, baseurl_separator) | ||
| """ % tuple(['/' if '@BASEURL@'[-1]!='/' else '']*2) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Not sure what this is used for, and the commit doesn't explain it
doc/manual/team.rst
Outdated
| requests and replies is done through the web interface at | ||
| |baseurlteam|. | ||
|
|
||
| Use the |problemseturlteam| page to get: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Leave the URL out here (as mentioned on the other commit)
doc/manual/team.rst
Outdated
| Use the |problemseturlteam| page to get: | ||
|
|
||
| - all attachments such as 'testing tools' to problems, | ||
| - view the submission and acceptance ratio during the contest as an indicator of the difficulty of a problem, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
What about something like this?
- view indicators for problem difficulty (submission and acceptance rates) across contest intervals (hover over the boxes for exact numbers),
This would give us more space in the team manual
|
Final manual. |
This was mentioned by @meisterT in another PR, so this is a start of documenting the
/problemspage. I removed thepascalexample as it forces us to another page and I suspect it's never needed (not sure how many tries it will save in a year).The resulting PDF:
domjudge-team-manual.pdf