Giter Site home page Giter Site logo

paulofreitasnt / comandos-git Goto Github PK

View Code? Open in Web Editor NEW
6.0 6.0 29.0 169 KB

Este repositório contém uma página que será construída de forma colaborativa com os alunos da turma de Gerência de Configuração e Mudanças

HTML 70.62% CSS 27.37% JavaScript 2.02%

comandos-git's Introduction

Olá, eu sou Francisco Paulo de Freitas Neto 👋

Linkedin Badge Gmail Badge

Sobre mim

  • 👨‍🎓 Bacharel em Ciência da Computação - UFERSA
  • 👨‍🎓 Mesre em Ciência da Computação - UFERSA
  • 👨‍🏫 Professor no IFPB, Cajazeiras

Áreas de interesse

  • NoSQL e NewSQL
  • Data Science
  • Business Intelligence

Disciplinas ministradas atualmente

Ferramentas e tecnologias

comandos-git's People

Contributors

adrielhigor avatar alexsanderarcelino avatar farley0909 avatar francisco-junior2021 avatar guilhermenrt7 avatar italo12346 avatar joseane-brilhante avatar kassiokley avatar kauanny-cmd avatar klinsman21 avatar ldavi8533 avatar lucasttavares avatar matheus9557 avatar matheusnunes133 avatar moacirdavidag avatar namenosyer avatar nathanpss avatar ngcguillherme avatar paulofreitasnt avatar raf-aad avatar railson-mateus avatar sabrinasalviano avatar vini92 avatar williamjbf avatar wotsons avatar yolisses avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

comandos-git's Issues

Proposta de mudança de background principal

⚠️ LABEL: improvement

📌 Prioridade: 3️⃣

Situação Atual:

A página atualmente tem um background não se encaixa no tema do Git.

Descrição:

Aplicar a alteração do background por um que represente melhor o Git como por exemplo: clique aqui

Adicionar um sumário para a página

Prioridade 5

Um dos principais problemas da página que eu pude notar é a navegação, com todo esse conteúdo fica difícil para o usuário navegar entre os tópicos devido ao tamanho da página e ficar usando o scroll toda hora pode ser uma tarefa frustrante para experiência do usuário, por isso eu sugiro a criação de um sumário para a página contendo os tópicos da mesma, isso facilitaria a navegação do usuário, pois caso ele queira ir para um tópico específico basta clickar no link para o tópico desejado livrando o usuário de ficar usando o scroll do mouse, outra sugestão é a criação de um botão de voltar para o topo da página, pois quando o usuário chega no último tópico a única maneira de voltar para o primeiro e com o scroll. Acredito que com a implementação dessas funcionalidades o usuário teria uma navegação bem mais atrativa.

label: Improvement

Melhoria no css do final da pagina

Melhoria no css no final da pagina

Prioridade: 2

Situação: tanto o "footer" quanto o formulário de contato não apresentam responsividade.

Descrição: uma melhoria no css , apresentando uma maior organização para aparelhos com telas menores

Adicionar exemplos em imagens

Adiconar imagens para melhorar a descrição dos comandos

  • Poderia ser implementado imagens dos comandos usados no terminal para demonstrar oque será mostrado no terminal cada comando.

Prioridade de mudança: 1 (Desejável)

  • A imagen poderia ser implementada a baixo da descrição de cada comando.

print

Adicionar letras claras ao rodapé

📌 Label:

  • 🟡 Melhoria

Prioridade Nível: 2️⃣

Situação:

Atualmente no rodapé do projeto a mistura entre letras escuras e fundo escuro torna extremamente difícil de visualizar o que está escrito.

image

Descrição:

Utilizando css é fácil alterar o estado atual apenas adicionando uma class aos itens do footer e criando uma tag no arquivo css para mudar a cor destes textos:

image
image

Mudança do design do site para algo mais minimalista e simples

Olá!
Situação: Atualmente o site tem um design simples, porém bagunçado. As cores utilizadas no site não tem nenhuma conexão entre si e eu sinto uma sensação de que as seções de conteúdo estão soltas.
**Prioridade: ** (2) - Isso não é tão primordial, nem urgente, mas pode ser pensado para longo prazo.
Mudança proposta: Eu sugeriria que o site fosse reformulado para ter um design minimalista, com cores harmônicas, formas bem definidas e um toque mais moderno. O site vai ficar mais bonito e intuitivo de acessar, bem como a experiência de usuário será melhor com um novo design.

Adicionar exemplos em vídeo.

🚧 LABEL: Improvement

📌 PRIORIDADE: 1️⃣ (desejável).

🔴 Situação:

  • A pagina se limita em mostrar apenas em mostrar os comandos, e dificulta para pessoas iniciantes que estão possivelmente sofrendo com erros.

✔️ Descrição:

  • Adicionar links de vídeos ou colocar na própria pagina, contendo exemplos de como realizar comandos e de como iniciar o git desde a instalação ao ponto mais complexo.
  • Irá ajudar iniciantes com dificuldades de aprender, e com dificuldades em aprender lendo os exemplos.

Melhorar a visibilidade da página

Label: improvement

Melhorar a visibilidade da página

Prioridade: 1 (desejável)

Situação atual

  • O site se encontra com os códigos e logo a baixo a descrição, Deixando o corpo da pagina extenso e cansativo.

Sugestão

  • Minha sugestão é ocultar a descrição dos códigos para facilitar caso o usuário esteja procurando algum em especifico. Com as descrições ocultas seria mais rápida a leitura de toda a página. Apresentando-as ao clicar no código.

Organizando ideia sobre o site e semântica do HTML

Organizando ideia sobre o site e semântica do HTML

Organizando ideia central do site

Nível 1 - Desejável

  • Decidir se o site é sobre comandos git ou comando git e de comandos do linux;
  • Qual abordagens do ensinamento o site irá transmitir, se será comentários curtos ou longos.

Organizando a semântica do HTML

Nível 1 - Desejável

  • Decidir se o site terá header, o mesmo é usado para apresentação do site contendo menus, logos, slides shows;
  • Acrescentar a tag main na linha 27 e fechando na linha 225, com isso definindo o conteúdo central do site;
  • Acrescentar a tag section na linha 28 e fechando na linha 244, definindo a sessão de comandos;
  • Acrescentar a tag article para cada comando git adicionado no site, com isso retirando as varias tag div.

Adição de links e outros comandos

LABELS

🟡 Melhoria 🔵 documentação

Situação atual:

O site está visivelmente bem agradável, embora não ter muito destaques funções mais importantes e também não estarem seguindo uma ordem muito logica.

Sugestão de mudanças:

(Prioridade: 2)> Seria interessante a adição de links nos títulos das funções para que se torne mais fácil a navegação entre os tópicos;
(Prioridade: 5)> Falta alguns comandos essenciais como o git push, git pull entre outros;
(Prioridade: 4)> É citado o git revert, mas não encontrei o git commit, tornando assim o git revert meio desnecessário;
(Prioridade: 3)> No read.me poderia ter um preview do site além de um link levando para o github.io do mesmo;

Criar novas páginas dentro da página principal para uma melhor legibilidade e entendimento do conteúdo.

-Improvement

-Prioridade: 3

-Situação: São muitos comandos listados em apenas uma página, dificultando assim o entendimento do conteúdo para o usuário final.

-Descrição: Seria necessário criar pelo menos duas páginas dentro do index.html principal, para separar o conteúdo, deixando assim o site menos confuso ao usuário. Uma página apenas com os comandos Git e a outra página com as descrições dos comandos, deixando assim a página principal como um Menu para os conteúdos.

Adicionar um botão para subir ao topo da página

📌 Label:

  • 🟡 Melhoria 🔵 Documentação

📍 Prioridade Nível: 2️⃣

Situação ❗

  • A página no momento se encontra sem um meio prático de voltar ao início da página, com isso, o usuário tem que fazer o movimento com o scroll do mouse ou subir a barra lateral para conseguir chegar ao início do site.

Descrição ✔️

  • Adicionar um botão utilizando o html, css e javascript para que, de uma forma mais prática, o usuário consiga voltar ao início da página com apenas um click.
  1. No documento HTML:
    1.1 Adicionar uma tag <button> com um id;
    1.2 Colocar a antes de fechar a tag <button> um nome para aparecer dentro do botão;
    1.3 No final irá ficar assim:
<button id="id_escolhido">nome_escolhido</button>
  1. No arquivo CSS:
    2.1 Criar um id com o mesmo nome informado no id do <button> e o configure;
    2.2 Configurando o id em css:
 #nome_escolhido{
    position: fixed;
    bottom: 20px;
    right: 20px;

    border-radius: 50%;
    width: 70px;
    height: 50px;
    color: white;
    background-color: cor_escolhida;
    border: none;
    display: none;
  1. No arquivo javascript:
    3.1 Adicionar uma função que irá fazer o botão aparecer e desaparecer no site quando o scroll for alterado;
    3.2 Função scroll:
// pegando o botão
let botao = document.querySelector('#id_escolhido');
// o id_escolhido é o mesmo id que foi escolhido na tag button
function scroll(){
   let btn = botao;
     if(document.documentElement.scrollTop > 200){
         btn.style.display = 'block';
     }
     else{
         btn.style.display = 'none';
     }
}
// a função scroll faz o botão aparecer se o scroll for maior que 200 e desaparecer caso contrário

3.3 Função voltarTopo:

botao.addEventListener('click', voltarTopo);
// toda vez que o usuário clicar no botão ele vai chamar a funcão voltarTopo e voltar ao topo
  function voltarTopo(){
      document.documentElement.scrollTop = 0;
  }

3.4 Mudar a cor quando o mouse entra e sai da região o botão:

botao.addEventListener('mouseenter', inside);
function inside(){
    let btn = botao;
        btn.style.backgroundColor = 'cor_escolhida';
        btn.style.color = 'cor_escolhida';
}
// mudar a cor quando o evento "mouseenter" for pego
botao.addEventListener('mouseout', outSide);
function outSide(){
    let btn = botao;
        btn.style.backgroundColor = 'cor_escolhida';
        btn.style.color = 'cor_escolhida';
    }
// mudar a cor quando o evento "mouseout" for pego

Melhorias no comando nano

LABELS 📝

Improvement 🟡

Prioridade 5 🔴


Situação 🧾 :

Melhorias na explicação do $ nano, a explicação do comando está básica, apenas falando como criar um arquivo usando o nano sendo que existe diversas opções e usos para o mesmo.


Descrição 🖥️ :

Deve ser adicionado os comandos e opções para um melhor entendimento do usuário, pois o mesmo auxilia muito quando possui uma grande quantidade de arquivos:
O usuário deve apertar a tecla CTRL + opção desejada para que seja realizado a ação.

o usuário deve usar o comando nano nome do arquivo e sua extensão, exemplo nano index.html para que possa criar ou editar um arquivo pelo editor.

A) CTRL + X: permite sair do editor, caso tenha feito alguma alteração no arquivo o mesmo vai perguntar se deseja realizar a alteração, para isso deve responder, y para yes e n para no.
B) CTRL + K: deleta por completo a linha que estiver selecionada no editor.
C) CTRL + U: Desfaz a opção anterior, retornando a linha deletada.
D) CTRL + S: Salva o arquivo e exibe o número de linhas escritas na parte inferior do editor.
E) CTRL + W: Permite pesquisar o texto posicionando o cursor.


Ancorar os comandos da lista às suas respectivas descrições

📌Label:

🟡 Melhoria 🔵 Documentação

🚩 Prioridade: 2️⃣ (desejável)

Situação:

Conforme a lista de comandos vai aumentando seria interessante considerarmos a ancoragem de elementos dentro da própria página para melhorarmos a navegabilidade. Ainda mais quando se pensarmos que hoje os usuários são leitores com pouco engajamento na leitura de textos completos. Assim, quando o usuário clicar em um comando específico ele será guiado até a sua descrição.

Descrição:

Com HTML poderíamos criar uma espécie de âncora que linka diferentes elementos sem sair da mesma página. Por exemplo, para linkar o primeiro comando Git Init com a sua descrição:

  • Nós determinaríamos um identificação id para o primeiro elemento de descrição.
    <h3 id = "git-Init"> Git Init </h3>

  • No comando Git Init inserimos uma referência de link href apontando para a id especificada anteriormente, precedida por uma #.
    <li><a href = "#git-Init"> Git Init </a> - Inicializa um repositório git em um diretório ou reinicializa um existente.</li>

Isso seria feito para cada comando que for sendo acrescentado.

Mudança no design do site para um mais moderno e minimalista

💛 Melhoria
Olá!
Situação: Atualmente o site tem um design simples, porém bagunçado. As cores utilizadas no site não tem nenhuma conexão entre si e eu sinto uma sensação de que as seções de conteúdo estão soltas. ⚠️
Prioridade: (2) - Isso não é tão primordial, nem urgente, mas pode ser pensado para longo prazo. 2️⃣
Mudança proposta: Eu sugeriria que o site fosse reformulado para ter um design minimalista, com cores harmônicas, formas bem definidas e um toque mais moderno. O site vai ficar mais bonito e intuitivo de acessar, bem como a experiência de usuário será melhor com um novo design. ✔️

Resolvendo alguns bugs e deletando linhas desnecessárias.

Resolvendo alguns bugs e deletando linhas desnecessárias.

🔴 bug 🔵 documentation

Prioridade ❗

Nível: 5

Situação 🤒

  • No formulário de contato está dando erro a carregar a imagem de fundo
  • Existe, por algum motivo, um conteúdo desnecessário já descrito anteriormente na pagina.
  • Algumas tags inúteis foram encontradas.

Descrição 👨‍💻

  • Deletar todas as linhas do html entre 213 e 223.

Irá deletar o fechamento de tag inexistente </header>, como também um conteúdo já descrito anteriormente.


  • Reescrever a linha 208 do css com:
    background: url("../img/contato.jpg") no-repeat center;

Irá resolver o problema com o background do formulário de contato.

Adicionar um design responsivo na página

📌 Label: Improvement

🚩 Prioridade: 2️⃣ (desejável)

❌ Situação:
Em suma, temos um design total, um tanto agradável à quem visualiza a página. Mas para termos um conforto ainda maior, independente de onde vimos, precisaríamos de uma responsidade na mesma.
Ao observarmos de um smartphone, por exemplo, vemos uma "quebra" no layout, segue uma amostra:

image

✔️ Uma possível solução seria uma adição na própria documentação da página, com o uso de Media Queries, exemplo:
@media screen and (max-width: valor escolhido px) { /* estilos */ }.

Organização e estruturação dos componentes da página e mudanças no design.

⚠️ LABEL:
Improvement - Para sugerir melhorias na página em si.

🔍 Prioridade da Mudança: 1 (Desejável)

🔴 Situação:
No momento página se encontra estruturada em blocos, com informações descritas que complementam umas as outras e algumas informações estão soltas. Existe também, no design, uma diversificação de cores e fontes.

📝 Descrição da Mudança:
-Manter a estrutura da página dividida em blocos porém, adicionar mais páginas para dividir os blocos e certificar-se de que todas as informações estão dentro do seu respectivo bloco mantendo assim a organização.
Porque por mais que as informações se complementem não dá para jogar para o usuário uma enxurrada de informações
numa única página.
-Padronização de cores e fontes.
Para obter uma harmonia de cores e fontes na página, gerando assim conforto e proporcionando uma boa experiência ao
usuário.

Saltar para comando ao começar a digitar

Prioridade 1

(desejável)

Situação

Atualmente o visitante precisa percorrer procurando o comando, o que é um incômodo.

Descrição

Para facilitar quando se esquece como usar dado comando, em vez de procurar manualmente na página ou depender do conhecimento do usuário quanto à ferramenta de busca do navegador, poderia se adotar um sistema semelhante aos dos gerenciadores de arquivos, em que basta começar a digitar o nome. Além disso adicionar o comentário, no fundo da página, de que essa opção está disponível.

Configuração do rodapé - Posicionando no final da página

Configuração do rodapé 🚩

🔴bug - Para relatar um problema ou erro

Prioridade:

5️⃣

Situação:

Código posiciona o rodapé ao lado da box de contato quando deveria posicionar ao final da página. Isso pode ser corrigido configurando o <footer> da página através dos passos a seguir.

Descrição:

  • Passo 1️⃣ - 🔄 Mudar o padding da <div class="container"> para:

.container{ position: relative; width: 100%; height: 100%; display: flex; justify-content: center; align-items: center; padding: 80px 100px; }

Isso Possibilitará que o footer possa se posicionar no final da págiana.

  • Passo 2️⃣ - ✔️ adicionar o seguinte código ao css da página:

footer{ background-color:rgba(153, 151, 151, 0.5); position:absolute; bottom:0; width:100%; height: 20px; }
@paulofreitasnt

Endereçamento dos comandos para páginas com exemplos mais elaborados

📃 Label: Improvement

  • ✒️ Prioridade: 2 (Tal adição deixaria o site mais intuitivo e abrangente, porém não é totalmente essencial para o funcionamento do site)

  • ✏️ Atualmente o documento se encontra organizado apenas como uma lista corrida, disponibilizando apenas leituras que pode se tornar cansativas ao longo do tempo

  • 📂 A mudança sugere que os comandos git estejam linkados a vídeos ou documentações de que destrincham melhor o comando, além do que é mostrado no site, com tal mudança, até as descrições já apresentadas poderiam ser menores e mais minimalistas, assim, deixando o corpo do site visivelmente melhor.

Adicionar uma melhor descrição aos comandos Git

Prioridade 1 📌

Ideias 💭

  • A descrição dos comandos git está logo abaixo dos comandos git que já estão pré comentados, uma descrição mais elaborada pode ser algo bom já que muitas descrições estão bem básicas! 1️⃣
  • Para uma descrição mais elaborada a ideia de uma nova aba para cada descrição é viável, já que é possível adicionar imagens e um texto bem mais elaborado! 2️⃣

Melhorar a o README do projeto para alcançar uma documentação mais completa

📑 LABEL: documentation

📌 Prioridade: 4️⃣

Situação:

Atualmente a documentação se encontra extremamente simples contendo apenas informações básicas.

Descrição:

Desenvolver uma descrição mais detalhada do projeto, bem como os objetivos finais da atividade, descrever os contribuidores e apresentar uma previa do projeto, como por exemplo os comandos git descritos.

Add a search bar

⚠️ LABEL: Improvement

📌 Priority: 4️⃣

🔴Current situation:

Without the search bar, the user must scroll through the entire page to find the command in doubt and want to consult.

📝Description:

By implementing a search bar to search for Git and Linux commands, it will be quicker to search for a specific command on the page.

Melhorias no Layout do site

📝 Label

  • Improvement;

🟢 Prioridade

  • (1) Desejável;

🌱 Situação

  • Menu topo:

    • Atualmente o site não possui um menu no seu topo.
  • Tópicos:

    • Atualmente o site é divido por Comandos do Git e Git Init.
  • Footer:

    • Atualmente o site não possui um footer (rodapé).

✏️ Descrição

  • Menu topo:

    • Criação de um menu do tido ancora no topo da página, que sua função ao clicar seria redirecionar para algum ponto específico dentro do próprio site.
  • Tópicos:

    • Dividir o site em mais tópicos e configurar junto ao menu, para que seja possível navegar em forma de ancora pelo site. Um exemplo seria dividir a primeira parte do site, criando um tópico (div) específico para "Comandos do Git" e um outro para "Comandos Linux".
  • Footer:

    • Construir um Footer (rodapé) para o site, inserindo as informações do curso e da turma.

Melhorar responsividade do formulário de contato

Label:

improvement

Prioridade:

Situação:

O formulário de contato não ocupa o card da forma mais estética possível, todos os campos se encontram no lado direito do card.

Descrição:

Alinhar os campos no meio do card, para ter um aproveitamento melhor de espaço.

Adicionar animações

IMPROVEMENT

Prioridade nivel 1

Situação

O usuário navega no site de forma que fica meio confusa a visualização dos tópicos, assim dificultando a leitura.

#Descrição

Adicionar animação de aparecer os tópicos e acordo com a forma que o usuário visualiza o site, assim, a visualização fica menos confusa e o usuário tem mais facilidade de ler todo o conteúdo.

Mudanças no CSS e Melhoramento do Javascript

Label 📌

Documentation 📃

Improvement 💡

Situação:

O site precisa ainda de algumas melhorias uma delas é o afunilamento de informações atualmente o site esta muito conteudista e pouco interativo, o que vai na contramão na maioria dos sites bem desenvolvidos da internet que buscam serem o mais interativos e limpos de informações possível tornando assim uma experiência melhor para o usuário.

Prioridade 5: 📣

O texto do lado da parte do contato esta praticamente inlegível, sugestão é que mude a cor da letra para branca ou coloque dentro de um box branco, igual ao que esta no resto do site.

Prioridade 3: 📢

Adição de Expressões Regulares para validação dos campos do formulário Email,Telefone e Nome.

Prioridade 2: ✒️

Como foi falado na Situação, o ideal é tentar encaminhar o site para uma proposta mais limpa e interativa

Configuração do rodapé - Posicionando no final da página

//Mudança na

, alteração do padding (de 20 para 80px)//
.container{
position: relative;
width: 100%;
height: 100%;
display: flex;
justify-content: center;
align-items: center;
padding: 80px 100px;
}
//inserir no arquivo css as seguintes configurações do //
footer{
background-color:rgba(153, 151, 151, 0.5);
position:absolute;
bottom:0;
width:100%;
height: 20px;
}

Mudança no Css para o melhoramento do designer visual

Label 📌

Improvement 💡

Prioridade 5 🚩

Situação: afim de melhorar o designer e agradar o usuário de forma q o site fique mais liso, foi incrementado o titulo como fixo para toda a pagina.

Descrição : 🔈

Foi adicionada as seguintes linas de codigo para a alteração feita no CSS:

  1. position: fixed; (Para fixar o container )
  2. left: 0; (Manter o cantainer colado a lateral)
  3. top: 0; (Para definir a distancia do topo)
  4. width: 100%; , height: 5%; (Definir a altura e largura do container)

Capturar

Capturar 2

Como podemos perceber quando a rolagem da pagina acontece, o titulo acompanha. 📍

Capturar3

Adição de conteúdo

📌 Label: improvement

⚠️ Prioridade - 3

Situação:

  • Atualmente o conteúdo da página se encontra limitado, fazendo com que o usuário não adquira o conhecimento necessário para o uso das ferramentas.

Descrição:

  • É necessário que haja a adição de conteúdos
  • É sugerível a adição de uma página com conteúdos extras, links e curiosidades, que auxilie no aprendizado do usuário.

Adicionar Menu Flutuante Lateral

Prioridade 1: Desejável 📌


Descrição: 📝

Seria interessante e funcional se fosse adicionado um menu flutuante lateral, onde ao clicarmos nas opções pudéssemos passear por cada sessão da página.

Sessões que o Menu poderia conter:

- Comandos git
- Descrição dos Comandos
- Contato

____________________________________________________________________________________________________________________________________

Objetivo: 🎯

Contribuir para melhorar a experiência do usuário.

____________________________________________________________________________________________________________________________________

Linguagens que poderiam ser utilizadas: 💻


Exemplo no link abaixo:

https://www.w3.org/Style/Examples/007/menus.pt_BR.html

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.