Por favor, documente melhor o plugin Discourse Calendar

Contribuir Feedback do site
1

Continuando a discussão de Discourse Calendar — já que minha postagem lá será excluída automaticamente após um mês.

A postagem principal que descreve este plugin precisa de alguns ajustes. É realmente confusa. Especificamente:

Confusão de Eventos

Parecem existir três coisas separadas chamadas “evento”:

  1. O mais básico: uma resposta com [date], que é exibida em um calendário na primeira postagem do tópico.
  2. Uma primeira postagem em um tópico que contém [event], usada pelo recurso opcional “estado alfa” descrito separadamente aqui.
  3. Um plugin completamente separado com um nome semelhante: Events em vez de Event.

Isso é… confuso.

Sintaxe pouco clara para o evento básico de tópico único

  1. Como definir o nome do evento? A descrição do plugin mostra texto com eventos, mas não como isso foi realmente definido.
  2. Como criar eventos recorrentes?
  3. O calendário de feriados mostra cores. O calendário regular também pode ter cores e, se sim, como?
  4. O recurso “eventos” separado pode aparentemente produzir um feed ical. Um calendário “básico” pode?

Mais perguntas sobre o calendário de feriados

Ele usa a mesma sintaxe do calendário por tópico ou do “evento”? Ele se limita a “feriados da equipe” ou pode ser usado por qualquer pessoa que possa responder a um determinado tópico? De onde vêm as cores? O emoji :desert_island: “Flair de feriado” é mutável? É possível torná-lo visível para qualquer pessoa, ou para um grupo arbitrário, não apenas para a equipe?

Etc…

Algumas dessas coisas eu descobri sozinho ou perguntando ao suporte. Mas realmente precisa ser documentado no tópico de documentação do plugin.

Provavelmente também seria bom detalhar algumas das limitações — a data de início da semana não segue seu local e não é configurável, todo o sistema está confuso sobre fusos horários… e se há um roteiro ou planos para abordar algumas dessas coisas ou adicionar novos recursos (ou se não há!), por favor, diga isso também.

Obrigado! Este é um recurso útil do Discourse que poderia ser muito útil para muitas pessoas, mas também é bastante confuso.

7 curtidas
2

Essa postagem é uma wiki - então você pode fazer suas próprias contribuições para ela facilmente. Isso seria muito útil para todos.

6 curtidas
3

Eu posso, embora algumas coisas sejam apenas suposições!

2 curtidas
4

Encontrei isto em Tópicos Relacionados enquanto fazia uma atualização dos tópicos de Calendário e Eventos (mais uma vitória para Tópicos Relacionados :slight_smile: :medal_sports: )

Acabei de reorganizá-los para que ambos os recursos agora apareçam corretamente como um tópico de plugin, o que espero que remova alguma confusão:

Também dividi muitos dos detalhes de ‘como fazer’ em alguns guias para lhes dar algum espaço:

O foco principal foi dar-lhes uma estrutura mais consistente (embora eu tenha adicionado uma rápida atualização para garantir). Eles foram um pouco espinhosos para suavizar, mas acho que estão em melhor forma do que estavam. Tendo dormido sobre isso, acho que há algumas coisas que ainda gostaria de fazer, então ainda não vou usar o :rocket:. :slight_smile:

Mas espero que estejamos indo na direção certa. :crossed_fingers: :slight_smile:

8 curtidas