BOCA Manual for the judges

From a9aa438ea0558eb0044cf1e54a9190ddb41b65e5 Mon Sep 17 00:00:00 2001 From: cassio Date: Tue, 2 Jul 2013 09:44:46 +0400 Subject: restructuring of boca's git --- boca-1.5.1/doc/html/.htaccess | 1 - boca-1.5.1/doc/html/manualjudge.en.html | 203 -------------------------- boca-1.5.1/doc/html/manualjudge.pt_br.html | 219 ---------------------------- boca-1.5.1/doc/html/manualteam.en.html | 198 ------------------------- boca-1.5.1/doc/html/manualteam.pt_br.html | 227 ----------------------------- 5 files changed, 848 deletions(-) delete mode 100644 boca-1.5.1/doc/html/.htaccess delete mode 100644 boca-1.5.1/doc/html/manualjudge.en.html delete mode 100644 boca-1.5.1/doc/html/manualjudge.pt_br.html delete mode 100644 boca-1.5.1/doc/html/manualteam.en.html delete mode 100644 boca-1.5.1/doc/html/manualteam.pt_br.html (limited to 'boca-1.5.1/doc/html') diff --git a/boca-1.5.1/doc/html/.htaccess b/boca-1.5.1/doc/html/.htaccess deleted file mode 100644 index 605d2f4..0000000 --- a/boca-1.5.1/doc/html/.htaccess +++ /dev/null @@ -1 +0,0 @@ -Allow from all diff --git a/boca-1.5.1/doc/html/manualjudge.en.html b/boca-1.5.1/doc/html/manualjudge.en.html deleted file mode 100644 index a7f8a0e..0000000 --- a/boca-1.5.1/doc/html/manualjudge.en.html +++ /dev/null @@ -1,203 +0,0 @@ - - - - -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/boca-1.5.1/doc/html/manualjudge.pt_br.html b/boca-1.5.1/doc/html/manualjudge.pt_br.html deleted file mode 100644 index eabeecc..0000000 --- a/boca-1.5.1/doc/html/manualjudge.pt_br.html +++ /dev/null @@ -1,219 +0,0 @@ - - - - -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/boca-1.5.1/doc/html/manualteam.en.html b/boca-1.5.1/doc/html/manualteam.en.html deleted file mode 100644 index 815eda0..0000000 --- a/boca-1.5.1/doc/html/manualteam.en.html +++ /dev/null @@ -1,198 +0,0 @@ - - - - - -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/boca-1.5.1/doc/html/manualteam.pt_br.html b/boca-1.5.1/doc/html/manualteam.pt_br.html deleted file mode 100644 index efa3871..0000000 --- a/boca-1.5.1/doc/html/manualteam.pt_br.html +++ /dev/null @@ -1,227 +0,0 @@ - - - - - -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.