Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

#96 - refact: padronizacao componentes e classes css #118

Merged

Conversation

Ester-Arruda
Copy link
Contributor

#96 - refact: padronizacao componentes e classes css

🆙 CHANGELOG

  • Padronizamos nomenclatura dos repositórios que contém os componentes para notação kebab-case e idioma inglês;
  • Padronizamos nomenclatura de componentes para o idioma inglês;
  • Padronizamos nomenclatura de classes CSS para o idioma inglês e notação kebab-case.

⚠️ Me certifico que:

  • Não deixei nenhum novo warning, erro ou console.log nas minhas modificações
  • Fiz deploy para ambiente de teste certificando que o build não quebrou
  • Solicitei code review para 2 pessoas
  • Solicitei QA para 2 pessoas
  • Obtive aprovação de QA e posso fazer merge

⚠️ Como testar:

-[ ] Acesse o repositório nossa-casa-front;
-[ ] Acesse a branch 96-refact/padronizacao-componentes-e-classes-css;
-[ ] Verifique a nomeação dos repositórios dos componentes e verifique se contém notação kebab-case e idioma inglês.
-[ ] Verifique a nomeação dos componentes e verifique se estão no idioma inglês.
-[ ] Verifique a nomeação das classes CSS e verifique se contém notação kebab-case e idioma inglês.

@@ -53,27 +53,27 @@ const Parceires = () => {
}
}}
modules={[Navigation]}
className="mySwiper"
className="my-swiper"
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Talvez partner-swiper seja mais descritivo?

Suggested change
className="my-swiper"
className="partner-swiper"


export const EventsPage = () => {
return (
<EventsContainer>
<NavBar />
<Events />
<Parceires />
<CarouselEvents />
Copy link
Member

@yrachid yrachid Nov 29, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fiquem totalmente a vontade para ignorar, pois esse nome não está errado nem nada, mas eu acho que ele ficaria mais natural na seguinte forma (estou sendo chato não me matem pfv):

Suggested change
<CarouselEvents />
<EventsCarousel />

import fotoNossaCasa from './nossacasa.png'
import Parceires from '../../components/parceires'
import ModalGallery from '../../components/modal-gallery'
import photoOurHouse from './nossacasa.png'
Copy link
Member

@yrachid yrachid Nov 29, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Como regra geral, não somente em código, mas em tradução português para inglês e vice versa, não se traduz nome próprio.

Talvez um nome mais apropriado seja:

Suggested change
import photoOurHouse from './nossacasa.png'
import nossaCasaImage from './nossacasa.png'

</div>
</div >
</section >
<section className="galeria">
<h2 className='titulo-galeria'>Galeria de fotos</h2>
<section className="galery">
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<section className="galery">
<section className="gallery">

<section className="galeria">
<h2 className='titulo-galeria'>Galeria de fotos</h2>
<section className="galery">
<h2 className='title-galery'>Galeria de fotos</h2>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<h2 className='title-galery'>Galeria de fotos</h2>
<h2 className='title-gallery'>Galeria de fotos</h2>

@@ -21,7 +21,7 @@ export function HomePage() {
const urlCms = process.env.REACT_APP_URL_CMS

useEffect(() => {
cms.get('api/events/?populate=foto_divulgacao').then((response) => {
cms.get('api/CarouselEvents/?populate=foto_divulgacao').then((response) => {
Copy link
Member

@yrachid yrachid Nov 29, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Isso aqui deveria mudar mesmo? A menos que algo tenha mudado do lado do CMS também, isso aqui vai quebrar essa página.

Vocês testaram localmente?

@@ -160,7 +160,7 @@ const Home = styled.div`
}
}

.galeria {
.galery {
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
.galery {
.gallery {

@@ -70,7 +70,7 @@ const Events = () => {
<SwiperSlide>
<div>
<div>
<img className="img-foto" src={urlCms + events.image_url} />
<img className="img-photo" src={urlCms + events.image_url} />
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

O nome img-photo acaba sendo um pouco redundante:

Suggested change
<img className="img-photo" src={urlCms + events.image_url} />
<img className="event-img" src={urlCms + events.image_url} />

<FontAwesomeIcon icon={faLocationDot} size="lg" />
Terapia presencial em {therapies.attributes?.local}
</div>
</p>
</div>
</li>
<li>
<div className="therapieType">
<div className="therapie-type">
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<div className="therapie-type">
<div className="therapy-type">

@@ -151,7 +151,7 @@ export const DetailsTherapies = () => {
<li>
{therapies.attributes?.url_agendamento == null && (
<>
<div className="inscriptionIcon">
<div className="inscription-icon">
Copy link
Member

@yrachid yrachid Nov 29, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

O que esse ícone faz? É para se inscrever no evento? Se for, sugiro outros nomes, pois inscription não traduz para o sentido correto de inscrição nesse contexto.

Como estamos estudando inglês na Aceleradora, acho que essa é uma boa oportunidade de aprofundarmos o aprendizado, então vou ativar meu modo palestrinha abaixo

Contexto

Em português, a palavra inscrição tem mais de um significado.

Nesse caso, a tradução para "inscription" traduz ela no seguinte significado (conforme link acima):

"Caracteres gravados no mármore, na pedra etc., para consagrar uma pessoa ou um fato: inscrição cuneiforme."

Como provavelmente estamos nos referindo a inscrição no sentido de inscrever-se em um evento, outras traduções mais apropriadas seriam:

  • sign-up
  • register
  • attend
  • join
  • rsvp

Essa última é uma sigla que vem da expressão em francês "répondez s'il vous plaît.", que traduz mais ou menos para "favor responder".

Embora seja uma expressão em francês, ela é amplamente utilizada por falantes nativos do inglês (pelo menos nos EUA), assim como muitas outras palavras oriundas da língua francesa (como "fiancée", por exemplo).


Se eu fosse escolher uma das traduções sugeridas, acho que usaria "attend", que é uma forma que vejo no Meetup, uma plataforma com um domínio parecido com o da Nossa Casa:

Screenshot 2023-11-29 at 09 52 03

@@ -122,7 +122,7 @@ export const WorkshopDetails = () => {
<li>
<div className="div-local">
<p className="local">
<div className="spacingLocal">
<div className="spacing-local">
Copy link
Member

@yrachid yrachid Nov 29, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Em inglês, local pode acabar sendo um pouco ambíguo no contexto de localização (raramente vejo essa palavra sendo usada nesse contexto). Sugestões:

Suggested change
<div className="spacing-local">
<div className="spacing-venue">
Suggested change
<div className="spacing-local">
<div className="spacing-location">

@@ -174,7 +174,7 @@ export const WorkshopDetails = () => {
</ul>
</span>
<p className="description">Descrição da oficina</p>
<p className="descriptionCMS">{workshops.attributes?.descricao}</p>
<p className="description-cms">{workshops.attributes?.descricao}</p>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Precisamos especificar que essa descrição tem algo a ver com o cms? Acho que CMS é um detalhe de implementação que não importa aqui.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Eu acho que tu acha que é cri-cri, porém faz sentido em questão de padronização. Pode acabar ficando confuso depois

Copy link
Member

@yrachid yrachid left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Eu deixei um monte de comentário cri-cri pq eu sou insuportável, desculpem não me matem pfv.

Talvez o único que não seja cri-cri seja esse abaixo, que parece ter sido uma renomeação acidental que vai causar bug:

#118 (comment)

No mais, essa PR tá show de bola, tudo bonitinho e padronizado

feels-good

Entretanto, ela está grande demais e vocês vão sofrer com conflitos, talvez tivesse sido melhor quebrar essas mudanças em PRs menores

@Ester-Arruda Ester-Arruda force-pushed the 96-refact/padronizacao-componentes-e-classes-css branch from 435642f to 80c78ad Compare December 4, 2023 19:02
@fernandesmelo fernandesmelo merged commit 9920349 into main Dec 5, 2023
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants