BOCA Manual for the judges

From be2491b093b1f0ca430bede679ecbb670041e483 Mon Sep 17 00:00:00 2001 From: cassio Date: Tue, 2 Jul 2013 09:46:45 +0400 Subject: restructuring of boca's git --- doc/html/.htaccess | 1 + doc/html/manualjudge.en.html | 203 +++++++++++++++++++++++++++++++++++ doc/html/manualjudge.pt_br.html | 219 ++++++++++++++++++++++++++++++++++++++ doc/html/manualteam.en.html | 198 +++++++++++++++++++++++++++++++++++ doc/html/manualteam.pt_br.html | 227 ++++++++++++++++++++++++++++++++++++++++ 5 files changed, 848 insertions(+) create mode 100644 doc/html/.htaccess create mode 100644 doc/html/manualjudge.en.html create mode 100644 doc/html/manualjudge.pt_br.html create mode 100644 doc/html/manualteam.en.html create mode 100644 doc/html/manualteam.pt_br.html (limited to 'doc/html') diff --git a/doc/html/.htaccess b/doc/html/.htaccess new file mode 100644 index 0000000..605d2f4 --- /dev/null +++ b/doc/html/.htaccess @@ -0,0 +1 @@ +Allow from all diff --git a/doc/html/manualjudge.en.html b/doc/html/manualjudge.en.html new file mode 100644 index 0000000..a7f8a0e --- /dev/null +++ b/doc/html/manualjudge.en.html @@ -0,0 +1,203 @@ + + + + +BOCA Manual for the judges + + +BOCA Online Contest Administrator +

BOCA Reference Manual for judges - +version October/2011 (BOCA 1.4.1+) +

+ +

Copyright (c) 2006-2011 Cassio P. de Campos (cassio@ime.usp.br).
+Permission is granted to copy, distribute and/or modify this document under +the terms of the GNU Free Documentation License, Version 1.2 or any later +version published by the Free Software Foundation; with no Invariant Sections, +no Front-Cover Texts, and no Back-Cover Texts. A copy of the license may be +found in http://www.gnu.org/licenses/

+ +

BOCA is a software created to control a contest with the ACM International Collegiate +Programming Contest rules. It has been developed in PHP and the interaction between judges +and the system is done through a web browser. In the following we describe +the set of available features for a judge in the system.

+ +

It is assumed here that the judge has already logged in the system with their +username and password in a windows of their browser. Tthe URL +to access BOCA will depend on the setup of your server. Usually this URL ends with +/boca/, where a simple authentication form will show up. + +

+After a successful login, the web page contains the judge identification in the upper-left +corner. In the upper-right corner, the clock of the contest is shown, indicating if it has +started or not, if it has already ended, stopped, or in progress, in which case the number of +minutes to go are displayed. Below that, there is a set of options in a vertical menu, namely +Runs, Score, Clarifications, History, As Team, Options e Logout. +There is still an extra option named Chief which only appear to the chief judge, who +has to be appointed in the admin's interface (with in the Site options). +

+ +

Runs

In this area, the judge might visualize the runs that are still to be judged and shall be +taken care of. In order to process a run, the judge has to click in its number (eventually a +message might pop up here indicating the run was already taken; this happens if another judge +got the run before you). After clicking on the run to judge, a new set of data appear about it: + +

Site: site number of the run.
Number: run number.
Time: minutes from the start of the competition until this submission.
Problem X: X is the name of problem. There are links +to download the input and output files (click on the names), or simply to visualize them in the browser (click on view). +These links are mostly used when the autojudge is turned off or is not running properly for a given problem/language. +Instead, if the autojudge feature is working correctly, then the judge can directly to go the links in the bottom part of +the page in order to see the expected output together with the output generated by the team. +
Language Y: Y is the language chosen by the team. The scripts that are used to +compile and execute the submission with this language are available through links. +When using the autojudge, note that is not necessary to use this links, because the results are +already shown in the bottom of the page. +
Source code: here it is possible to view or download the submitted file. An important +task is to check if the name and extension of this file are correct with respect to the chosen problem, language, +and the specification in the booklet of problem descriptions. +
Answer: the judge has to choose, among the options available in the system (which were configured by the admin), +the correct answer to be sent to the team. +
Autojudging answer: here it is presented the suggestion from the autojudge about this submission. +Usually the autojudge properly identify the answer that has to be sent to the team. However, it may +fail to do so. For example, the autojudge might indicate a wrong answer, because the +diff procedure identified the output and expected output to be different, while the only mistake +happened in the punctuation/accent of a letter (this is usually a case of presentation error, but +may vary according to the contest). Other issues might happen, and the role of the judge is to check everything +for eventual mistakes. +
Autojudged by: indicates the computer that has acts as autojudge. Usually this is not +much relevant for judging a submission. +
Standard output: links for downloading and visualizing the output generated by the team's code are +available. This is the output generated by the team, which is to be compared with the expected output of +the given problem. It might also be possible to see some error, in case it happened. +
Standard error: links for downloading and visualizing the standard error output generated by the team's code. +When a error happens (including compilation or runtime errors, but not restricted to them), this is the most probable file to identify it. +The judge must always check the content of this file. In the end of it, the judge also finds the output of the diff command +that has compared the team's output and the expected one (to facilitate the visual inspection). +

+ +

By pressing the button named Judge, the judge submits their veredict about the run, and then +has no access to the this run anymore. It is also possible to give up judging the run by clicking +on Cancel, which will send the run back to the pool (and it will be eventually judged by another judge). +

+ +

In the tab Runs, the judge can see all the submissions that are yet to be judged. The colors +represent their status, meaning that they are already been judged by others, or that they are waiting +you to judge them (red color). You must act with respect to those in red, as only you can judge them (or +send them back to the pool). +

+ +

Chief

+Besides acting as a normal judge, there is a designated judge with access to the tab Chief. This tab +is used for the chief judge to resolve disputes regarding submissions that received different answers by different +judges (they are shown in red). The prodecure is equivalent to that of a normal judge, but the decision made in the tab of the chief is +final. The idea is to have the chief judge acting as a tie-breaker between the distinct answers that were assigned to +a run. Hence, if the chief judge is acting as a normal judge (and they may do so), it is recommended to use +the tab Runs instead, leaving the tab Chief only for resolving issues. (In the very special case where there +is a single judge in the competition, then this judge has to be designated as chief and shall use the tab Chief +to judge the runs, otherwise they will never receive the judgement of another judge and thus will not be sent to teams.) +In this same tab, the chief judge is able to ask the autojudge to be re-executed for some submissions (selected by +the boxes besides each of them) or to completely re-open the submission for judging again, which implies in a new round +of autojudging and judging by actual judges. The team does not become aware of this rejudging unless the new final +result for the run has to be changed (with respect to the first round of judgement). +

+ +

Score

In this tab the judge can see the scoreboard of the competition. It has to be noted that the scoreboard available +for the judges is complete and not subject to the freezing of the final part of the contest. Hence, the judge is +expected to keep the scoreboard in secret. In case the scoreboard is consolidated among different sites, the final part +of the other sites is not shown (*this fact is for technical reasons, to be discussed later*). +

+ +

Clarifications

This tab allows the judge to answer clarifications submitted by team regarding +a specific problem or any general aspect of the contest. +In order to reply to a clarification, the judge must first click on the clarification number. +The box available in the bottom part is meant for creating a new clarification, as judges are allowed to do +so. The new clarification will only be meaningful if the judge that gets it to answer selected the reply to all +option (explained in the next paragraph). This is useful for the judges to send a general information to the teams. +

+ +

After clicking on the clarification number, the judge sees information about it, such as +site number, clarification number, time in minutes from the start of the competition, and the +problem to which the clarification regards. There are two text boxes: one with the question (on top) +and one to be filled with the reply. Finally, there is a selection box to indicate if the reply +should be sent to all the teams or just the the team that posted the question. +

+ +

The system also allows the judge to select the No response button. In general +this is used for questions that are already stated in the booklet of problem descriptions, or +that has already been replied, or even that should not be answered at all (for example, about +the timelimit of a problem, or about some sensitive information of the input/output). +

+ +

History

This tab shows the history of Clarifications and +Runs that were processed by the judge so far. +

+ +

Options

This tab shows the information of the judge, such as Username, +User full name , User description. It is possible +for the judge to update their password, although this is not necessary neither +recommended. Instead it is recommended that the admin who created the users already +specifies secret and safe password for all users. +

+
+ +

Logout

Button to log out from the judge interface.

+ +

Important hints for judges

While judging a submission, it is necessary to be very careful. Even if it is possible +to alter the judgement of a run afterwards, this has to be avoided as much as possible, because +the team might suffer an undesired situation. +

Every time a judge is about to answer a problem for its first time (that is, the problem has not +been submitted before, or has not received yet any YESes), when possible it is interesting to have other judges +also checking the submission, which should be analyzed with even greater care. Sometimes this is the +moment when an unfortunate issue with the autojudge or with inputs or outputs is discovered +(obviously nobody wants it to happen, but it might). +

In order to reply to clarifications, it is important that the judge has read and understood +the question and the problem to which it concerns. When possible, it is interesting to have the opinion +of the person or group that created the problem description, its input and output. After that, +it is necessary to think if such reply has to be sent only +to this user or to all teams in the contest. If it is a relevant issue and the contest is also offered in +other sites, then the judge shall find a way to contact other sites about the clarification. +Some examples of clarifications that are not disclosured (that is, are replied with a no response) +are +What is the timelimit for this problem?, +Given this input, which is the correct output?, +questions that are already explained in the problem description, +etc. +In case the judge is not certain about it, they must contact the chief judge of the site or the +chief judge of the contest for help. +

+ +

About BOCA and this document

BOCA System and this document have been created by Cassio Polpo de Campos and can be found at +http://www.ime.usp.br/~cassio/boca/.

+ +

+ + + +

diff --git a/doc/html/manualjudge.pt_br.html b/doc/html/manualjudge.pt_br.html new file mode 100644 index 0000000..eabeecc --- /dev/null +++ b/doc/html/manualjudge.pt_br.html @@ -0,0 +1,219 @@ + + + + +Manual do BOCA para as equipes + + +BOCA Online Contest Administrator - Sistema de Submissão +

Manual de Referência para os juízes - +versão setembro/2010 (para o BOCA versão 1.4.x) +

+ +

Copyright (c) 2006-2010 Cassio P. de Campos (cassio@ime.usp.br).
+Permission is granted to copy, distribute and/or modify this document under +the terms of the GNU Free Documentation License, Version 1.2 or any later +version published by the Free Software Foundation; with no Invariant Sections, +no Front-Cover Texts, and no Back-Cover Texts. A copy of the license may be +found in http://www.gnu.org/licenses/

+ +

O BOCA é um software criado para controlar uma competição nos moldes +da Maratona de Programação da SBC. Foi feito em PHP e a interação dos juízes +com o sistema é feita usando-se um browser. A seguir descrevemos a +interface disponível no BOCA para os juízes e suas principais funções.

+ +

Neste texto será assumido que o juiz já realizou o seu +login na máquina e abriu uma janela do navegador (leia +as instruções sobre o Maratona Linux ou sobre o sistema que +estiver sendo utilizado). O BOCA é acessado através de uma +URL (usualmente a página se chama +http://mainserver/boca ou http://bocaserver/boca). +Ao carregar a página, o juiz deverá ver a +tela de login do BOCA. Basta digitar o login do +BOCA fornecido ao juiz e a sua senha correspondente.

+ +

Após realizar o login com sucesso, uma página deverá ser aberta +contendo a identificação do juiz no canto superior esquerdo. +No canto superior +direito haverá a informação sobre o estado da competição: ou ainda não +começou, ou já acabou, ou está parada, ou a competição está em andamento e a +quantidade de minutos restantes será mostrada. Mais abaixo dessas primeiras +linhas estarão seis opções, que representam a interface propriamente dita do +BOCA. Estas seis opções são: Runs, +Score, Clarifications, History, Options e Logout. +Existe ainda uma opção extra para o juiz chefe (que deve ser previamente apontado através da +interface do admin no sistema): Chief. Ela não está disponível para os demais juízes. +

+ +

Runs

Ao entrar nessa opção, o juiz poderá visualizar as submissões que ainda +não foram corrigidas e devem ser processadas. Para corrigir uma submissão, +o juiz deve clicar sobre seu número (como é feito o tratamento de concorrência +para que dois ou mais juízes não peguem a mesma Run, neste momento o juiz pode +ser avisado que a Run acaba de ser pega por outro juiz). Ao clicar em uma +submissão, o juiz verá os seguintes campos: +

Site: número do site atual.
Number: número da Run sendo julgada.
Time: minutos decorridos da competição para esta submissão.
Problem X: X é o nome do problema. Ao lado, existem +links para fazer o download (clicando sobre o nome) ou simplesmente visualizar +os arquivos de entrada e saída (clicando em view). Usando o esquema de +autojudging, o importante é ficar atento à saída esperada, comparando-a com a +saída que o programa da equipe gerou.
Language Y: Y é a linguagem escolhida pela equipe. Ao +lado aparece o script para compilação e execução nesta linguagem. Note que, +utilizando o esquema de autojudging, não é necessário olhar para esse arquivo.
Source code: Aqui é possível visualizar (view) ou fazer o +download do arquivo submetido. Um ponto importante para o juiz é verificar se +o nome e a extensão desse arquivo estão de acordo com o problema e a linguagem +escolhidos.
Answer: Neste campo o juiz escolherá qual a resposta que será enviada +para a equipe. Para tomar essa decisão, ele tem à disposição os arquivos e botões +já mencionados e também, logo abaixo, os dados gerados pelo esquema de autojudging +(se esse esquema estiver sendo utilizado).
Autojudging answer: Resposta sugerida pelo esquema de autojudging. +Usualmente o autojudging acerta o que deve ser respondido às equipes, mas pode +falhar. Por exemplo, ele pode dizer que a resposta está errada (Incorrect Output), +pois comparou os arquivos e não eram iguais, mas o único erro do programa da +equipe foi na digitação de um acento em uma palavra (usualmente isso é simplesmente +um Output format error). Outros detalhes podem ocorrer, e o juiz deve +estar atento aos próximos demais dados fornecidos pelo autojudging.
Autojudged by: indica qual computador fez o autojudging, no +caso de diversos autojudgings estarem sendo utilizados. Usualmente não essencial +na correção.
Standard output: links para fazer o download ou visualizar a saída +padrão gerada pelo programa da equipe. Usualmente neste lugar deve estar a +saída que foi gerada pela equipe e que deve ser comparada com a saída esperada, +disponível no item Problem. Caso haja algum problema, eventualmente +pode ser possível visualizar o erro aqui.
Standard error: links para fazer o download ou visualizar a saída de +erro padrão gerada pelo programa da equipe. Quando um problema acontece, por +exemplo um erro em tempo de execução por causa de um acesso ilegal, a informação +sobre o erro torna-se disponível nesta saída de erro. Além de sempre +analisar essa saída, o juiz deve estar atento à saída padrão, pois máquinas virtuais +como da linguagem Java podem escrever os erros na saída padrão e/ou na saída +de erro. Na saída de erro está ainda o resultado do diff feito entre o arquivo + esperado e o arquivo gerado pelo programa submetido. +

+ +

Utilizando o botão Judge o juiz faz o julgamento da Run, e após +isso não tem mais acesso para alterar seu julgamento. É possível ainda devolver +a Run para o pool de submissões a serem julgadas, utilizando o +botão Cancel.

+ +

Na tela de Runs, o juiz visualiza todas as submissões, mesmo aquelas que +estão sendo julgadas por outros juízes. Tais submissões aparecem com a cor +azul. As submissões sendo julgados por ele próprio aparecem em vermelho, e somente +ele tem acesso para julgá-las (ou o admin, claro).

+ +

Chief

+Além de poder atuar como um juiz normal, um juiz pode ser designado como chief. Nesta aba +o juiz chefe tem a opção de julgar runs que foram previamente julgadas mas obtiveram resultados +diferentes dos diferentes juízes. A tela é similar àquela do juiz normal, só que runs +julgadas aqui são dadas como resposta final ao time, sem a necessidade de intervenção de outro juiz. +Por esse motivo, é aconselhável que mesmo o juiz chefe, quando estiver julgando runs sem conflito, apenas +utilize a aba Runs, e deixe para utilizar esta aba apenas para resolver os casos de runs que foram julgadas de +forma diferente por diferente juízes. Além das informações da run, o juiz chefe possui +(ao clicar sobre a run) as resposta contraditórias que foram dados pelos juízes, de forma a desempatar +a questão e enviar a resposta mais adequada ao time. +

+ +

Score

Nessa opção será mostrado o placar atualizado da competição. Vale a pena +lembrar que o placar disponível para os juízes é completo, e portanto +deve ser mantido em sigilo até a divulgação dos resultados finais da competição +(para manter o suspense :-).

+ +

Clarifications

Essa opção permite que o juiz responda as clarifications enviadas +pelas equipes a cerca de um problema específico ou de algum aspecto geral da +prova. Para responder uma clarification, o juiz deve clicar sobre seu +número Cuidado: a caixa de texto disponível na parte inferior não é para +responder perguntas, mas para elaborar uma pergunta. Isso serve para que um juiz +crie uma pergunta, que então poderá ser respondida por ele mesmo (ou por outros +juízes) e enviada para todas as equipes, funcionando assim como uma forma de +aviso geral.

+ +

Neste instante ele poderá visualizar informações sobre a clarification, +como número do site, número da clarification, tempo em minutos desde o +início da competição e problema sobre o qual +a pergunta está relacionada, além de duas caixas de texto: uma com a +pergunta e outra onde será preenchida a resposta. Se julgar relevante, o juiz +pode clicar nas seleções answer to all users in the site para que esta pergunta seja +respondida (enviada) para todas as equipes no site ou answer to all users in all sites +para que a resposta seja enviada para todas as equipes em todos os sites (no caso de +uma competição executada no BOCA em um único site, não há diferença entre estas seleções).

+ +

O sistema também permite que o juiz utilize um botão chamado +No response. Isso ocorre +em geral porque a pergunta feita não deve ser respondida, pois sua resposta faz parte do +entendimento da questão ou da prova, ou já foi respondida anteriormente. +Por fim, existe um botão onde o juiz pode devolver a clarification para que +outro juiz a responda. +

+ +

History

Ao entrar nessa opção, o juiz poderá visualizar as Clarifications e +Runs que foram respondidas/corrigidas até o momento. +Não é possível alterar nada, apenas visualizar.

+ +

History

Nesta aba o juiz pode atuar como uma equipe, submetendo runs para serem julgadas. +O uso deste item se dá no momento de testar o sistema e o conjunto de problemas. Juízes +podem submeter runs mesmo antes de iniciada a competição. +

+ +

Options

Entrando nessa opção poderão ser vistas as informações: Username, +User full name e User description do juiz. Também +será possível trocar a senha do juiz no BOCA digitando-se a senha antiga e a +nova (duas vezes). Para efetuar a troca da senha, basta preencher os campos +corretamente e clicar no botão Send. É importante ter uma senha +segura para um juiz.
+ +

Logout

Essa opção permite sair do BOCA.

+ +

Dicas importantes

Ao corrigir problemas, devemos tomar extremo cuidado. Ainda que seja possível +alterar a correção posteriormente (através do ambiente do administrador da competição), +isso implica que a equipe receberá uma resposta e, depois de certo tempo, outra. +Obviamente esse tipo de situação não é agradável.

Sempre que um dos juízes está corrigindo um problema pela primeira vez (ou ainda nas +demais vezes iniciais, isto é, até o momento foram feitas poucas submissões +desde problema), +é interessante que todos participem e tenham cuidados especiais, analisando a +submissão com calma. É possível que na primeira +submissão de um dado problema possamos descobrir um defeito no +sistema ou nos arquivos de entrada e saída (claro que torcemos para isso nunca aconteça :-). +

Para responder às clarifications, é necessário que o juiz tenha lido com +calma as questões e identifique se a pergunta é válida e deve ser respondida. Além disso, +é necessário considerar se a resposta deve ser enviada para todas as equipes ou apenas +para aquela que fez a pergunta. Perguntas típicas que não são respondidas são: +Qual o tempo limite desse problema?, Dada essa entrada, qual a saída correta?, +etc. Além disso, perguntas cujas respostas estão definidas nos enunciados normalmente +não são respondidas. +Caso haja uma dúvida sobre o que se deve responder, o juiz deve procurar o juiz-chefe +responsável pela prova. +

+ +

Sobre o BOCA e este documento

O sistema BOCA foi criado por Cassio Polpo de Campos +e pode ser encontrado em +http://www.ime.usp.br/~cassio/boca/. +Este manual foi feito por Cassio Polpo de Campos.

+ +

+ + + +

diff --git a/doc/html/manualteam.en.html b/doc/html/manualteam.en.html new file mode 100644 index 0000000..815eda0 --- /dev/null +++ b/doc/html/manualteam.en.html @@ -0,0 +1,198 @@ + + + + + +BOCA Team's Manual + + + +BOCA Online Contest Administrator +

Reference Manual for teams - version +October/2011 (BOCA version 1.4.1+)

+ +

Copyright (c) 2003-2010 Ulisses F. F. da Silva and Cassio +P. de Campos.
+Permission is granted to copy, distribute and/or modify this document under +the terms of the GNU Free Documentation License, Version 1.2 or any later +version published by the Free Software Foundation; with no Invariant Sections, +no Front-Cover Texts, and no Back-Cover Texts. A copy of the license may be +found in http://www.gnu.org/licenses/

+ +

BOCA is a software for controlling a competition in the scope of the ACM International +Collegiate Programming Contest. It has been developed in PHP and the interaction between teams +and the system is performed using a web browser. In the following it is described +this interface and its main functions.

+ +

It is important that teams tested the system during the warmup session, before +the official contest, so any issue can be addressed in time. The warmup has exactly this +purpose. It is expected that teams submit correct and incorrect runs, as long as they do not +try to perform malicious operations in the system. It is also expected that clarifications be +submitted, and a small file to print. +

+ +

It is assumed here that the team has already logged in using the web browser and +the URL address provided to access the BOCA system. The URL varies from contest to contest, +so you have to ask the staff of your site about it. The login page contains the fields +username and password, which are provided by the staff of the contest. Usually the +username follows the format teamX, where X is the team number, but that is +not mandatory (again, check with the staff). If not speficied, the initial password is empty.

+ +

After the successful login, a page opens with the team identification in the upper-left +corner, and the clock of the contest in the upper-right corner. During the contest, +as the team gets YESes as balloons appear besides the team name. +Just below this information, a vertical menu has the following options: +Problems, Runs, Score, Clarifications, Tasks, Backups, Options e Logout.

+ +

Problems

In this tab, the team sees the problems of the contest, together with the book of problem +descriptions (if available online). In in-loco contests, this tab is less important +given that a printed version of the booklet is distributed to the teams. Still, the column +named Basename provides to teams the name of the file that has to be used for each problem. +This is the name that has to be followed by the extension (depending on the language) and +also as the name of the class containing the public main procedure in Java. +Usually this information is also available in the booklet. Nevertheless, here the team can +check if their name is correct. +

+ +

Runs

This tab represents the actual information about the team's submissions, as well as provides +the interface to submit new runs. It is important for the team to select the correct +problem, language, and to choose the correct file for the submission. Note that the file name +must follow the specification in the booklet, and which shall also be available in the tab Problems. +Hence, +

Use in the source-code the filename defined in the column Basename of the tab Problems. + Take care with small typos and the proper extension according to the chosen language. +
Choose the correct language and problem. It is not uncommon to happen submissions with wrong filename, language or problem. +
Make sure your code reads the input from the standard input and writes the output to the + standard output. Avoid writing anything to the standard error. Furthermore, make your + program exit the code zero in the final return or exit(.) call. By default, this indicates that no + error has happened during its execution. +

+ +

In order to see the judgements of runs, the team must click on +the tab Runs and watch the list of submitted runs. +However, do not stop working while waiting for the answers. Even if the judges +are in the backstage working hard to reply to all submissions, this might take some time. +In the last part of the competition, the scoreboard is not updated, neither the runs are answered back +(the number of minutes from the end when this happens depends on the contest; usually it is something around +15 minutes, but this is informed by the staff). For each run, there is a set of standard answers that +exist in each contest (and they may vary depending on the contest). Still the common options are shown below: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Answer Description
YES Your code was properly compiled, run, and correctly generated the expected output for the problem.
NO: Wrong answer Some times known as Incorrect output. It indicates that the code compiled and ran, however it + did not generated the expected output for the problem, given the input of the judges (which most certainly + is different from yours and is not available to you).
NO: Time-limit Exceeded The code compiled properly but spent more than the maximum amount of time defined for the given problem. + This time-limit is defined by the judges for each problem and is not disclosed to the teams.
NO: Runtime Error The code compiled properly but achieved an error during its run, given the input of the judges. Some examples + of runtime error are: illegal memory access (seg. fault), illegal file access, excess of memory usage, etc.
NO: Compilation Error The code has not compiled properly in the judges' computers. Note that you are expected to have compiled in your + own computer before submitting the code. So check the compilation options and versions in your + computer, and if you do not have a problem compiling it locally, ask a member of the staff for help.
NO: presentation Error Also known as output format error, it means that your code compiled, ran, and generated the + expected output apart from some minor presentation issue, such as upper/lower-cases, acents or punctuations (the + definition of presentation error may vary in each contest and is defined by the judges who created the test set).
NO: If possible, contact staff This reply tells you to contact your local staff for help/asking about the issue, if at all possible.
+ +

Score

This tab shows the scoreboard of the contest. If running as a multi-site competition, the scoreboard might also +contain teams from other sites, which can be identified by the /X after the team name, where X is the +site number of the corresponding team. Note that the scoreboard is not updated during the last part of the competition. +This is indicated accordingly. +

+ +

Clarifications

This tab can be used by the team to submit questions to the judges concerning the problems, their descriptions, +or any other aspect of the contest. If the question is specific to a problem of the test set, the team must select +the problem from the combo list. Otherwise, the option General is to be used. The text box is used to +write the question. It is also available in this tab all the replies to questions that were formulated by the +team, as well as questions formulated by other teams but that judges decided that the reply should be made +available to all the teams. Some facts:

+ +

Teams must make questions regarding the problems and test set using only this interface, and not directly + to the staff or judges. +
It is the team's responsibility to check the tab about clarifications during the contest + to check for new replies. Judges may also send general clarifications to teams, and they will appear in this tab. +

+ +

BOCA allows judges to use a particular button named No response. If you receive this +reply it means that the question may not be answered by the judges, for instance because it is against +the rules to disclose such information, or because the judges understand that the +information asked is already available in the booklet of problem descriptions.

+ +

Tasks

This tab allows the team to send files for printing, as well as ask for help from a staff member (using +the button S.O.S.. To print a file, just select it from the disk and click on Send. +The help provided by the staff has to be only related to issues with the computers or other +physical problem, while questions about the test set, problem descriptions, etc must be send to the +judges using the tab Clarifications.

+ +

Backups

It is possible to send small files to BOCA in order to keep them safe in the server. This is +particularly useful if some drastic issue happens with your computer. This tab provides a way +for the teams to send and query back files that are stored in the server. Only very small files +are allowed, so it is recommended that you backup only plain text files (source code, inputs, etc) +and use a zip or tar.gz format to create a single file. +

+
+ +

Options

This tab shows the information of the team, such as Username, +User full name , User description. It is possible +for the team to update their password, although this is not necessary neither +recommended. Instead it is recommended that the admin who created the users already +specifies secret and safe password for all users. +

+
+ +

Logout

Button to log out from the team interface.

+ +

About BOCA and this document

BOCA System and this document have been created by Cassio Polpo de Campos and can be found at +http://www.ime.usp.br/~cassio/boca/. +An initial version of this document was made by Ulisses Furquim Freire da Silva. +

+ +

+ + + diff --git a/doc/html/manualteam.pt_br.html b/doc/html/manualteam.pt_br.html new file mode 100644 index 0000000..efa3871 --- /dev/null +++ b/doc/html/manualteam.pt_br.html @@ -0,0 +1,227 @@ + + + + + +Manual do BOCA para as equipes + + + +BOCA Online Contest Administrator - Sistema de Submissão +

Manual de Referência para as equipes - versão +setembro/2010 (para o BOCA versão 1.4.x)

+ +

O BOCA é um software criado para controlar uma competição nos moldes +da Maratona de Programação da SBC. Foi feito em PHP e a interação dos times +com o sistema é feita usando-se um browser. A seguir descrevemos a +interface disponível no BOCA para as equipes e suas principais funções.

+ +

É interessante que todos os times testem essas opções durante a +sessão de aquecimento (warmup) que antecede a competição. O +warmup tem exatamente esta função, e assim espera-se que cada equipe submeta +um problema correto, submeta um problema errado, faça perguntas aos juízes +através do sistema de clarifications e até submeta um arquivo pequeno +para impressão.

+ +

Neste texto será assumido que o time já realizou o seu +login na máquina e abriu uma janela do navegador (leia +as instruções sobre o Maratona Linux ou sobre o sistema que +estiver sendo utilizado). O BOCA é acessado através de uma +URL (endereços comuns são +http://mainserver/boca/ ou http://bocaserver/boca/). Ao carregar a página, o time deverá ver a +tela de login do BOCA. Basta digitar o login do +BOCA fornecido ao time e a sua senha correspondente (usualmente +algo como teamX, onde X +deve ser substituído pelo número da equipe. A senha inicial é +vazia caso não escolhida diferentemente).

+ +

Após realizar o login com sucesso, uma página deverá ser aberta +contendo a identificação do time no canto superior esquerdo. Durante a +competição, conforme o time acerta os problemas, pequenos balões coloridos +são apresentados próximos ao nome do time. +No canto superior +direito haverá a informação sobre o estado da competição: ou ainda não +começou, ou já acabou, ou está parada, ou a competição está em andamento e a +quantidade de minutos restantes será mostrada. Mais abaixo dessas primeiras +linhas estarão sete opções, que representam a interface propriamente dita do +BOCA. Estas sete opções são: Problems, Runs, +Score, Clarifications, Tasks, Backups, Options e Logout.

+ +

Problems

Ao entrar nessa opção, o time poderá visualizar as questões da prova. Para +cada questão, estará disponível um arquivo con sua descrição (muitas vezes +apenas um arquivo de descrição é dado, contendo todas as questões da prova). +Esta opção é normalmente utilizada para competições não-presenciais como forma de +distribuir a prova. Em competições presenciais, sua utilidade é reduzida. +Ainda nesta tela é possível visualizar as cores dos balões de cada problema.

+ +

Runs

Ao entrar nessa opção, o time poderá submeter as suas soluções e receber as +respostas dos juízes. Para submeter uma solução, o time deverá selecionar o +problema para o qual a solução foi feita, a linguagem utilizada e depois +carregar o arquivo contendo a solução. Depois disso, basta clicar no botão +Send para enviar sua solução. O botão Clear permite apagar os +dados selecionados. Algumas observações importantes na hora de criar e +submeter uma solução:

+ +

Crie o seu arquivo-fonte contendo a solução de um problema com o nome + indicado no enunciado. Cuidado com pequenos erros no nome e em sua extensão. +
Escolha a linguagem correta. Note que seu fonte deverá ter a + extensão correspondente para cada uma das linguagens aceitas (veja a folha + de questões da prova). +
Lembre-se de que sua solução deve ler os dados da entrada padrão e + escrever os resultados na saída padrão. Nada deve ser + escrito na saída padrão de erro. Além disso, programas escritos em + linguagens que possibilitam o retorno de algum valor para o sistema + operacional devem retornar o valor 0 (zero), que por convenção indica que + nenhum problema ocorreu na execução. +

+ +

Para receber as respostas dos juízes, o time deverá clicar em Runs e +esperar que a lista contendo as respostas recebidas para cada solução +submetida seja atualizada (ainda assim, não perca tempo esperando. Você pode +produzir enquanto a resposta dos juízes não chega). Vale a pena lembrar que +nos últimos minutos os times que submeterem soluções não receberão +mais as respostas dos juízes +(assim o suspense fica melhor, não? :-). Esse prazo é informado na +competição. Cada competição tem seu conjunto de respostas possível que as +equipes podem receber. A seguir apresentamos apenas uma tabela exemplo com as +respostas tradicionais. Verifique as especialidades da sua +competição.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Resposta	Descrição
YES	Seu programa foi aceito, e você receberá um balão da cor correspondente ao problema.
NO: Incorrect Output	Também conhecido como Wrong Answer. Indica que seu programa + respondeu incorretamente a algum(ns) dos testes dos juízes.
NO: Time-limit Exceeded	A execução do seu programa excedeu o tempo permitido pelos + juízes. Esse limite de tempo usualmente não é divulgado aos times e pode variar + para cada problema.
NO: Runtime Error	Durante o teste ocorreu um erro de execução (causado pelo seu + programa) na máquina dos juízes. Acesso a posições irregulares de + memória ou estouro dos limites da máquina são os erros mais comuns.
NO: Compilation Error	Seu programa tem erros de sintaxe. Pode ser ainda que você errou o + nome do problema ou linguagem no momento da submissão.
NO: Output Format Error	Também conhecido como Presentation Error, indica que a saída + do seu programa não segue a especificação exigida na folha de + questões, apesar do "resultado" estar correto. Corrija para se + adequar à especificação do problema.
NO: Contact Staff	Você deve pedir a presença do pessoal de staff, pois algum + erro incomum aconteceu.

+ +

Score

Nessa opção será mostrado o placar atualizado da competição. Vale a pena +lembrar que o placar será congelado antes do final da competição +(suspense mantido :-). Esse prazo também é informado na competição, e o placar +quando estiver congelado mostra um aviso sobre seu estado.

+ +

Clarifications

Essa opção permite que o time faça perguntas aos juízes a cerca de um +problema específico ou de algum aspecto geral da prova. O time deverá +selecionar o problema relacionado à sua pergunta ou selecionar General, +caso a pergunta não seja específica. Logo abaixo deverá ser escrito o texto da +clarification. Para enviar a clarification basta clicar no botão +Send. O botão Clear apaga os dados selecionados. Para visualizar +a resposta da clarification, o time deverá estar na opção +Clarifications e olhar na lista das clarifications submetidas se +a resposta já foi dada. Como já foi mencionado, uma lista contendo as +clarifications pertinentes a cada time será sempre mostrada nessa +opção. Algumas observações importantes sobre clarifications:

+ +

Os times devem fazer perguntas sobre a prova utilizando apenas essa + interface disponível no BOCA! +
O time deverá ficar atento às clarifications durante toda a + prova, pois uma clarification feita por um time poderá ser respondida + para todos os outros. Os juízes também podem enviar clarifications a todos + os times se julgarem conveniente. Fiquem atentos. +
As respostas de clarifications não surgem na tela. Você deve consultar esta página para vê-las. +

+ +

O sistema permite que o juiz respondendo uma dúvida utilize um botão chamado No response. Isso ocorre +em geral porque a pergunta feita não deve ser respondida, pois sua resposta faz parte do +entendimento da questão ou da prova. Neste caso sugerimos ler com cuidado as questões e as +possíveis clarifications relacionadas.

+ +

Tasks

Ao entrar nessa opção, o time poderá enviar arquivos para impressão. Para +isso o arquivo deve ser selecionado e então basta clicar no botão +Send. O botão Clear permite apagar os dados selecionados. Outra +opção neste item é o botão S.O.S. que pode ser usado para chamar a +ajuda do pessoal de staff. Essa ajuda deve estar relacionada apenas com +problemas do computador ou semelhantes, já que dúvidas sobre a prova devem ser +enviadas pelo sistema BOCA na opção Clarifications.

+ +

Backups

No sistema BOCA é possível enviar pequenos arquivos para que sejam +guardados no servidor em case de uma interrupção do funcionamento do computador +do time. Entrando nessa opção poderão ser vistos os arquivos já enviados +e mantidos no servidor, assim como enviar novos arquivos. Note que existe um limite usualmente +pequeno na capacidade de armazenamento para que não hajam abusos. Um arquivo compactado é +geralmente a melhor forma de guardar dados no servidor.
+ +

Options

Entrando nessa opção poderão ser vistas as informações: Username, +User full name e User description do time. Também +será possível trocar a senha do time no BOCA digitando-se a senha antiga e a +nova (duas vezes). Para efetuar a troca da senha, basta preencher os campos +corretamente e clicar no botão Send.
+ +

Logout

Essa opção permite sair do BOCA.

+ +

Sobre o BOCA e este documento

O sistema BOCA foi criado por Cassio Polpo de Campos +e pode ser encontrado em +http://www.ime.usp.br/~cassio/boca. +Este manual, em sua versão inicial, foi feito por Ulisses Furquim Freire da Silva e +complementado e atualizado por Cassio Polpo de Campos.

+ +

+ + + -- cgit v1.2.3

Answer	Description
YES	Your code was properly compiled, run, and correctly generated the expected output for the problem.
NO: Wrong answer	Some times known as Incorrect output. It indicates that the code compiled and ran, however it + did not generated the expected output for the problem, given the input of the judges (which most certainly + is different from yours and is not available to you).
NO: Time-limit Exceeded	The code compiled properly but spent more than the maximum amount of time defined for the given problem. + This time-limit is defined by the judges for each problem and is not disclosed to the teams.
NO: Runtime Error	The code compiled properly but achieved an error during its run, given the input of the judges. Some examples + of runtime error are: illegal memory access (seg. fault), illegal file access, excess of memory usage, etc.
NO: Compilation Error	The code has not compiled properly in the judges' computers. Note that you are expected to have compiled in your + own computer before submitting the code. So check the compilation options and versions in your + computer, and if you do not have a problem compiling it locally, ask a member of the staff for help.
NO: presentation Error	Also known as output format error, it means that your code compiled, ran, and generated the + expected output apart from some minor presentation issue, such as upper/lower-cases, acents or punctuations (the + definition of presentation error may vary in each contest and is defined by the judges who created the test set).
NO: If possible, contact staff	This reply tells you to contact your local staff for help/asking about the issue, if at all possible.