From 3fedbdd34c8534355eac775abbd203ad35905f6f Mon Sep 17 00:00:00 2001 From: Felipe Guaycuru Date: Tue, 4 Jul 2017 18:48:53 -0300 Subject: [PATCH] Atualiza o README e move a FAQ para o Github --- README.md | 26 ++++++++----- common/common.inc.php | 2 +- views/contato.php | 2 +- views/faq.php | 87 ------------------------------------------- 4 files changed, 19 insertions(+), 98 deletions(-) delete mode 100644 views/faq.php diff --git a/README.md b/README.md index 88c8b09..96e9731 100644 --- a/README.md +++ b/README.md @@ -1,21 +1,22 @@ ## Instalação ## -[ToDo] + 1. Instale o Composer de [getcomposer.org](https://getcomposer.org) + 2. Acesse a pasta raiz do projeto e rode o comando `composer install` + 3. Copie o arquivo `common/config-sample.inc.php` para `common/config.inc.php` + 4. Edite o arquivo `common/config.inc.php` com os dados apropriados + 5. Rode o comando `vendor/bin/doctrine orm:schema-tool:update --force` para criar as tabelas - 1. getcomposer.org - 2. composer install - 3. common/config-sample.inc.php -> common/config.inc.php - 4. vi common/config.inc.php - 5. vendor/bin/doctrine[.bat] orm:schema-tool:update --force - -## FAQ - Perguntas Frequentes ## +## Sobre este projeto ## P: Este é o GDE "de verdade"? R: Sim e não: Esta é a versão 2.5 do GDE, atualmente a versão "em produção" é a 2.3. P: Qual a diferença entre a versão 2.3 e a 2.5? -R: Em termos de funcionalidades: "avisos", "fóruns", "grupos" e "oportunidades" foram removidos (não eram utilizados). Em termos de backend: a versão 2.3 foi escrita entre 2009 e 2012, e contém código antigo, desatualizado, potencialmente inseguro e, sinceramente, às vezes vergonhoso. Nenhuma biblioteca ou framework foi utilizada, foi tudo feito do zero. Na versão 2.5 está tudo sendo reescrito para utilizar o ORM [Doctrine](http://www.doctrine-project.org/ "Doctrine"). Além disso, a versão 2.5 suporta disciplinas com a mesma sigla e níveis diferentes, cursos com o mesmo número e níveis diferentes e oferecimentos com turmas com mais de 2 caracteres. +R: Em termos de funcionalidades: "avisos", "fóruns", "grupos" e "oportunidades" foram removidos (não eram utilizados). Em termos de backend: a versão 2.3 foi escrita entre 2009 e 2012, e contém código antigo, desatualizado, potencialmente inseguro e, sinceramente, às vezes vergonhoso. Nenhuma biblioteca ou framework foi utilizada, foi tudo feito do zero. Na versão 2.5 foi tudo reescrito para utilizar o ORM [Doctrine](http://www.doctrine-project.org/). Além disso, a versão 2.5 suporta disciplinas com a mesma sigla e níveis diferentes, cursos com o mesmo número e níveis diferentes e oferecimentos com turmas com mais de 2 caracteres, além de várias outras correções menores. +P: Quando o GDE 2.5 vai ao ar? +R: Assim que algum as burocracias envolvidas forem resolvidas. Espero que isso ocorra antes de 2018! + P: Já foi tudo reescrito? R: Não, esse é um processo lento e trabalhoso, e infelizmente estou fazendo tudo sozinho. @@ -67,3 +68,10 @@ R: Porque eu acredito que a comunidade de alunos (e ex-alunos) da Unicamp podem P: Posso colaborar? R: Sim, por favor! Faça fork e envie seu pull request! + +P: Como posso ajudar? +R: Depende: + + - Se você sabe programar em PHP, fique a vontade para corrigir um problema ou criar uma nova feature. Seu pull request será analisado com carinho! + - Se você é designer, crie um novo layout mais moderno (quem sabe, responsivo) para o GDE, ou melhore o atual, e envie seu pull request. + - Se você não se encaixa em nenhuma das opções anteriores, envie sugestões ou problemas encontrados criando uma [Issue](https://github.com/guaycuru/gde/issues). diff --git a/common/common.inc.php b/common/common.inc.php index 2a634e4..cca7c55 100644 --- a/common/common.inc.php +++ b/common/common.inc.php @@ -220,7 +220,7 @@ diff --git a/views/contato.php b/views/contato.php index bc15107..e9706bb 100644 --- a/views/contato.php +++ b/views/contato.php @@ -25,7 +25,7 @@ }); // ]]> - Antes de enviar sua mensagem, consulte as "Perguntas Frequentes", talvez você encontre respostas...

+ Antes de enviar sua mensagem, consulte as "Perguntas Frequentes", talvez você encontre respostas...

Recomendar o GDE

diff --git a/views/faq.php b/views/faq.php deleted file mode 100644 index 4d83ca2..0000000 --- a/views/faq.php +++ /dev/null @@ -1,87 +0,0 @@ - -

F.A.Q. do GDE


- Encontre aqui respostas para as perguntas mais frequentes com relação ao GDE. Este FAQ está em constante atualização...

-

Sobre o GDE


- P: O que é o GDE?
- R: Boa pergunta. O GDE começou como um fim-de-semana ocioso (7 e 8 de Março de 2009) e uma idéia: Juntar as informações públicas da DAC num lugar só. Resolvi (incentivado por alguns amigos) colocá-lo na Internet (16/04/09). Com o passar do tempo, fui acrescentando mais funcionalidades e opções (e não tenho planos de parar).

- P: Pra que serve o GDE?
- R: Bom, o GDE serve para: -
- P: O que significa GDE?
- R: Precisa significar alguma coisa? No início significava, mas com as novas funcionalidades que ele foi agregando, o termo original perdeu um pouco do sentido.

- P: Quem está por trás do GDE?
- R: Além de mim (Felipe Guaycuru, pros que tenham preguiça de fazer uma consulta por Guaycuru), grande parte da sua existência se deve à minha esposa Najara, à minha irmã Paula Guaycuru e aos meus amigos que cumprem as funções (voluntariamente) de beta-testers, além de sempre estarem dando sugestões e me incentivando a continuar.

-
-

Utilizando o GDE


- P: Como editar meu perfil?
- R: Para editar seu perfil, existe um link embaixo da sua foto (Editar Perfil). Lá você pode por suas informações pessoais, - foto, email para contato e por aí vai. Além de poder editar opções de privacidade para sua árvore de disciplinas. - Aconselhamos que deixe seu perfil sempre atualizado.

- - P: Como adiciono um amigo?
- R: Primeiramente, deve-se fazer uma busca pelo nome de seu amigo utilizando o campo no canto direito superior. - Ao encontrar seu amigo, selecione-o e clique no link para adicioná-lo.

- - P: Como aceitar um pedido de amizade?
- R: Os pedidos de amizade ficam perto do link Amigos, sendo uma imagem amarela. Não há como errar :)

- - P: Como achar uma sala, um professor ou disciplina?
- R: Basta fazer uma pesquisa utilizando o campo de busca no canto direito superior e apertar o botão Enter ou clicar na lupa. - Em seguida, os resultados aparecerão. Entre na aba desejada e divirta-se.

- - P: Como elimino do meu currículo / árvore uma disciplina já cursada?
- R: Você tem duas opções para fazer isso:
- 1) No menu Ferramentas -> Árvore / Integralização, clicar nas disciplinas que já fez, e clicar em "Eliminar"
- 2) Buscar as disciplinas que já cursou, acessar a aba Disciplina e clicar no link "Eliminar" localizada na aba Curso

- - P: Como coloco uma disciplina de volta no meu currículo / árvore?
- R: Para colocar a disciplina de volta na árvore, efetue uma busca, clique na disciplina em questão, e clique no link "Nenhuma das Anteriores"...

- - P: Como elimino Eletivas da minha árvore?
- R: Para eliminar Disciplinas Eletivas, busque pela Disciplina (no menu Disciplinas) que você cursou como Eletiva, e clique no link "Eliminar".

- - P: Por que não posso consultar a árvore de alunos que não têm cadastro no GDE?
- R: Para montar a árvore de um usuário, é necessário saber qual o catálogo do Aluno. Essa informação infelizmente não é disponibilizada publicamente.

- - P: Por que as disciplinas que cursei não estão aparecendo?
- R: Para que as disciplinas apareçam, você deve verificar se seu catálogo está correto através do perfil ou - eliminar as disciplinas cursadas pela busca ou árvore.

- - P: Por que não usa o RA do Aluno para descobrir seu catálogo / ano de ingresso?
- R: Porque, infelizmente, desde 2002 não existe mais uma equivalência entre RA e ano de ingresso. Por exemplo: Em 2007, os primeiros alunos ingressantes ganharam RA 069xxx...

- - P: Existem atalhos para facilitar o uso do GDE?
- R: SIM! Os seguintes atalhos podem ser utilizados a vontade: - -

- -