search

filipedeschamps / tabnews.com.br

Conteúdos para quem trabalha com Programação e Tecnologia.
https://tabnews.com.br
GNU General Public License v3.0
5.32k stars 388 forks source link

Adicionar um FAQ ao site #1380

Closed hkotsubo closed 9 months ago

hkotsubo commented 1 year ago

Atualmente o site não tem um FAQ, e acho que seria útil, pelo menos para explicar o funcionamento básico de algumas coisas. Tem a página "Sobre", é verdade, mas ela só dá uma ideia geral do site. Acho que falta um lugar que explique certas coisas de maneira mais detalhada, como por exemplo:

aprendendofelipe commented 1 year ago

Olá @hkotsubo, com certeza a milestone do revenue share não poderá ser concluída sem o FAQ estar pronto. Mas nada impede que já seja criada uma versão na milestone atual. 💪

Sobre a mecânica dos TabCoins, ainda virão mais mudanças na milestone atual, mas como vi sua pergunta dentro do TabNews, eu já estava escrevendo uma resposta, então criei uma issue para manter a descrição do que está valendo atualmente. 👍

A criação das regras para uso de TabCash será o objetivo principal da próxima milestone. 🚀

Sobre limitar o que pode ser postado, eu acho complicado restringir. E o ideal é que a mecânica de qualificações do sistema cuide disso. Então os ajustes vão ocorrer sempre que necessário para levar o Equilíbrio de Nash cada vez mais perto do ideal.

hkotsubo commented 1 year ago

@aprendendofelipe Quanto aos limites, é só pra ter uma regra clara. Um exemplo (bem exagerado de propósito): se alguém postar uma receita de arroz com frango (sem qualquer relação com tecnologia), estará fora das regras, acredito eu, e a pessoa poderá ser advertida.

Tendo a regra escrita no FAQ, dá mais subsídio pra gente poder afirmar que esse tipo de coisa não pode. Se não está escrito em nenhum lugar, sempre abrirá margem para discussão (talvez não no meu exemplo, mas enfim, podem ter casos em uma área cinzenta, e ter as regras ajuda a dar um norte).

aprendendofelipe commented 1 year ago

Show @hkotsubo, você já tem algo em mente para iniciar uma issue sobre que tipo de conteúdo pode postar no TabNews?

Acho que uma issue específica pode atrair mais gente querendo contribuir ou acompanhar esse assunto.

hkotsubo commented 1 year ago

você já tem algo em mente para iniciar uma issue sobre que tipo de conteúdo pode postar no TabNews?

@aprendendofelipe Minha ideia era partir de alguma discussão já existente (até pra ter mais embasamento), mas em uma busca rápida pelo site não encontrei.

O máximo que tem são as páginas "Sobre" e "Termos de Uso", mas elas só mencionam "conteúdo de valor concreto para quem trabalha com programação e tecnologia". É meio vago e bem subjetivo, mas enfim, é o ponto de partida que temos.

Enfim, amanhã penso nisso com mais calma. Mas se quiser já ir abrindo a issue, fique à vontade :-)

Lembrando que os assuntos listados acima são apenas sugestões de itens do FAQ. Mas nada impede que o FAQ seja criado com outros itens, que vcs achem mais pertinentes.

hkotsubo commented 1 year ago

Bom, outra sugestão de item pro FAQ: "Posso postar o mesmo conteúdo várias vezes?" (resposta: "Não").

Inspirado nesta discussão.

ygcristopher commented 1 year ago

Seria bem interessante mesmo, implementar um FAQ.

Rafatcb commented 11 months ago

Vale mencionar tem um PR de FAQ que estava em andamento antes do surgimento dessa issue: https://github.com/filipedeschamps/tabnews.com.br/pull/1210. Já tem algumas informações lá e talvez o PR possa ser aproveitado para a criação do FAQ completo.

Rafatcb commented 10 months ago

Um PR atualizado sobre o FAQ acaba de ser aberto: https://github.com/filipedeschamps/tabnews.com.br/pull/1581

Dêem uma olhada e vejam se as perguntas foram bem respondidas e se existe algo faltando. Nada impede uma atualização do FAQ em outro PR, se necessário, mas aproveitem agora para avaliar.

Rafatcb commented 10 months ago

Pessoal, o PR #1581 foi mergeado mas resolvi não fechar esse issue por alguns motivos discutidos lá. Temos algumas melhorias pendentes:

  1. Renomear a pergunta Por que o TabNews foi criado? para Qual é o propósito do TabNews? (referência). Não precisa mudar o id nem a resposta.
  2. Eventualmente, publicações serão criadas no TabNews por mim ou pelo @aprendendofelipe para complementar o FAQ. A primeira pergunta será para responder "O que é o TabNews?". Com o debate, um PR deve ser aberto para criar essa pergunta e a resposta, e já atualizar o ponto 1 dessa lista no mesmo PR.
  3. Possivelmente, uma publicação será criada para melhorar a resposta Que tipo de assunto é aceito no TabNews?. Referência.
  4. Possivelmente, outra publicação será criada para falar sobre "qualidade" no FAQ e poder orientar o comportamento para votos (o que estimular e o que desestimular).

Foi discutido que a melhor forma de criar as publicações de melhoria seriam com uma pergunta por vez, para concentrar a discussão com um foco específico. Pensei também em mencionar que outras melhorias para o FAQ devem ser sugeridas neste issue, para não gerar discussões paralelas na publicação.

Se você sentiu falta de alguma pergunta/resposta ou achou que alguma resposta poderia ser melhor, já pode deixar seu feedback aqui.

PS: As publicações não serão criadas todas de uma vez para não dividir a atenção da comunidade, vamos resolver uma pergunta por vez.

Rafatcb commented 10 months ago

Criei a publicação para ouvir da comunidade a resposta para O que é o TabNews?, mas teve feedback sobre o FAQ também. Vou trazer o comentário do kht para cá:

Tem dois trechos que podem dar margem a alguma confusão, pois pra mim eles parecem contraditórios.

Primeiro é dito que posso publicar "qualquer outro tipo de conteúdo que poderá fazer alguma diferença na vida de quem trabalha em áreas diretamente ou indiretamente relacionadas à área de tecnologia".

E logo depois temos"O conteúdo publicado no TabNews deve estar diretamente relacionado à tecnologia".

No meu entendimento, a primeira regra dá a impressão de que posso falar de qualquer coisa. Usando um exemplo exagerado de propósito, eu poderia falar de culinária ("olha essa receita super saudável"), afinal devs também precisam comer e uma boa alimentação faz "diferença na vida" de qualquer um, não?

Mas a segunda regra restringe isso, deixando bem claro que não posso falar de culinária, a menos que tenha uma relação clara com tecnologia (por exemplo, como fazer um site de receitas, etc).

Talvez seja o caso de ajustar o texto da primeira, pois acho que "qualquer outro tipo de conteúdo que poderá fazer alguma diferença na vida" é amplo demais. Tem que deixar claro que não é bem qualquer coisa, tem que estar de acordo com a segunda regra.

O trecho considerado abrangente está na pergunta Que tipo de conteúdo eu posso publicar no TabNews?. Concordo que ele pode dar uma abertura à interpretações que não desejamos, mas ainda não pensei numa frase para substituir.

Rafatcb commented 9 months ago

Atualizando:

Conforme as melhorias implementadas no PR #1605, o último ponto restante para considerar este issue como encerrado é criar uma publicação para falar sobre "qualidade" no FAQ e poder orientar o comportamento para votos (o que estimular e o que desestimular). Não sei se vamos conseguir definir algo mais objetivo para colocar no FAQ, mas vou criar a publicação para ver se conseguimos algo.

Outras melhorias podem ser feitas no FAQ com o passar do tempo, mas o fechamento deste issue será apenas para considerar que a necessidade de ter um FAQ foi atendida.

Rafatcb commented 9 months ago

Acabei de criar o PR abordando o assunto da qualidade: https://github.com/filipedeschamps/tabnews.com.br/pull/1625

A publicação que recebeu feedback no TabNews foi essa: Complementando o FAQ - O que é um conteúdo de qualidade?

Após esse ponto ser definido no FAQ, vamo fechar esse issue como resolvido. Apesar disso, melhorias no FAQ continuarão sendo bem recebidas.