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

Apresentação de tabelas #18

Open
Tchez opened this issue Jul 11, 2023 · 2 comments
Open

Apresentação de tabelas #18

Tchez opened this issue Jul 11, 2023 · 2 comments

Comments

@Tchez
Copy link

Tchez commented Jul 11, 2023

Olá, gostei muito da série de vídeos e gostaria de contribuir no projeto

Assistindo à série, me senti motivado e gostaria de fazer minha primeira contribuição em um projeto open source. Para isso, estou pesquisando formas alternativas de representar a resposta do CLI na documentação de forma que não fique quebrada como a atual:


image

Pensei três alternativas e gostaria de discutir a possibilidade de implantação de alguma delas.

  1. Tabela do markdown
  2. Print
  3. Tabela usando HTML e CSS

Segue meu ponto de vista acerca das alternativas:

Tabela do markdown

Estilo dela ficou um pouco desconexa com relação à resposta estilizada do CLI


markdown-table

Print

Maneira que melhor representa a realidade, logo, a mais bonita. Porém, provavelmente o @dunossauro teve essa ideia, mas não usou por algum motivo


print-table

Tabela usando HTML e CSS (print está sem estilização CSS)

Pode ser uma solução ao problema da estilização do markdown. Usando CSS é possível chegar à um estilo fidedigno da resposta apresentada pelo CLI


html-table

Conclusão

Das alternativas apresentadas, creio que o print seria a forma mais fácil e que melhor representa a resposta no CLI. Porém, o fato de não ter sido usado anteriormente me faz pensar se realmente é a melhor forma haha. Com relação ao markdown, não vejo como uma boa opção pois a table do HTML é bem parecida, com o diferencial de poder ser estilizada usando CSS. Vejo o uso do HTML e CSS apenas no caso da não utilização de prints, por conta do processo de estilização demandar uma boa experiência em CSS pra tabla ficar exatamente como a resposta no CLI.

Espero feedback de qual a melhor alternativa e o pq :)

@dunossauro
Copy link
Owner

Eu acabei não usando o print por questão de acessibilidade. O que daria pra fazer seria colocar o print e a tabela que está sendo usada agora como o alt da imagem. O que você acha?

E obrigado pela issue :hearth:

@Tchez
Copy link
Author

Tchez commented Jul 13, 2023

Faz sentido! Não tinha pensado nessa possibilidade 😅

Implementei aqui e o inspecionar ficou assim:

image

Segue link do meu commit de exemplo:
Tchez@bd36766

Se aprovar a alteração, tiro print do meu CLI mesmo? Se preferir os seus, pode me mandar que eu adiciono os alts e titles respectivos :)

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

No branches or pull requests

2 participants