Skip to content
Leonardo Celente edited this page Apr 30, 2021 · 4 revisions

O que é o Zenith Website?

Este é o projeto do website hosteado em Zenith Aerospace. O site tem o objetivo de mostrar ao mundo os projetos e iniciativas do grupo Zenith. Nós, os membros do grupo, estudamos desenvolvimento web para criar uma experiencia que fosse agradável e transmita qualidade técnica dos membros. Aqui neste repositório Git estão os arquivos que compõem tudo que é mostrado no site, os textos, as imagens e todo conteúdo com que você interage foi construído aqui.

Como funciona (A Stack)

Se você esperava ver arquivos HTML descrevendo o conteúdo deve ter estranhado, nosso site foi feito usando o framework React.JS que nos permite descrever HTML usando JavaScript. Adicionalmente usamos a técnica de Server-Side Rendering (SSR), então descrevemos nosso site todo usando JavaScript, mas o usuário recebe HTML, o que permite que tenhamos a flexibilidade de JavaScript na hora de programar, mas o usuário não é impactado em termos de velocidade. O SSR funciona com o framework Next.JS. Mas não adianta ter toda essa stack de tecnologias sem ter um lugar onde hospedar nosso site, para isso temos o apoio da Vercel. A cereja do bolo é que a Vercel nos da a habilidade de ter mudanças feitas durante o desenvolvimento serem automaticamente refletidas no site público e a criação de versões experimentais, prática conhecida como Deploy Continuo (CI/CD).

A Estrutura

Nosso site é estruturado como de costume para um site feito com React, existem arquivos que representam páginas inteiras (/pages), e existem arquivos que formam pedaços, componentes do todo, (/components). Quando esses componentes são associados aos arquivos de estilo CSS (/styles) e imagens (/public/images) o esqueleto do site é completo. Mas nosso site tem mais uma distinção: é um site internacional. Isso significa que o conteúdo do site muda de acordo com o idioma do usuário. Como o conteúdo varia, os componentes recebem os textos de uma variável que é controlada por uma biblioteca que gerencia qual o idioma deve ser mostrado.

Contribuições e Desenvolvimento

Para esse projeto seguimos um Workflow Git bem definido. Então para contribuir com o site é preciso um pouco de organização. Primeiro, se você não é membro do Zenith faça um fork do projeto para ter uma cópia em seu perfil do GitHub, nessa cópia crie uma branch com seu nome e o propósito, ex: fulano/melhorar-footer. Caso você já seja do Zenith crie a branch diretamente no repositório. Nessa branch faça suas mudanças (commits) e então quando sentir que concluiu seu trabalho faça um Pull Request para que sua contribuição seja incluida no projeto. Lembrando que tarefas que precisam de contribuição estão organizadas no quadro do GitHub Projects desse repositório

Clone this wiki locally