Discourse Calendarプラグインのドキュメントを改善してください

Discourse Calendar からの議論の続きです。そちらの投稿は1か月後に自動削除される予定です。

このプラグインを説明するトップ投稿は、少し修正が必要です。非常に混乱しています。具体的には:

イベントの混乱

「イベント」と呼ばれるものが3つあるようです:

  1. 最も基本的なもの:[date] を含む返信。トピックの最初の投稿にあるカレンダーに表示されます。
  2. トピックの最初の投稿に含まれる [event]。オプションの「アルファ状態」機能で使用されます。こちらで別途説明されています
  3. 似た名前の完全に別のプラグイン:Events instead of Event

これは…混乱します。

基本的な単一トピックイベントの構文が不明瞭

  1. イベントの名前はどうやって設定しますか?プラグインの説明にはイベントを含むテキストが表示されていますが、それが実際にどのように設定されたかは示されていません。
  2. 繰り返しイベントを作成するにはどうすればよいですか?
  3. ホリデーカレンダーには色がついています。通常のカレンダーにも色をつけることはできますか?できる場合、どうすればよいですか?
  4. 別の「イベント」機能は、icalフィードを生成できるようです。「基本」カレンダーでも可能ですか?

ホリデーカレンダーに関する追加の質問

これは、トピックごとのカレンダーと同じ構文を使用しますか、それとも「イベント」の構文を使用しますか?「スタッフの休日」に限定されますか、それとも特定のトピックに返信できる人なら誰でも使用できますか?色はどこから来るのですか?:desert_island:「ホリデーフレア」絵文字は変更可能ですか?スタッフだけでなく、誰にでも、または任意のグループに表示することは可能ですか?

その他…

これらの質問の一部は、自分で調べたりサポートに尋ねたりして解決しました。しかし、プラグインのドキュメントトピックに記載する必要があります。

また、制限事項についてもいくつか明確に説明した方が良いでしょう。週の開始日はロケールに従わず、設定もできません。タイムゾーンに関する混乱もあります…そして、これらの問題に対処したり、新機能を追加したりする予定があるかどうか(またはないかどうか!)についても、ぜひ教えてください。

ありがとうございます!これは非常に便利なDiscourseの機能で、多くの人に役立つ可能性がありますが、同時にかなり混乱しやすいものでもあります。

「いいね!」 7

その投稿はウィキなので、簡単に自分で貢献できます。それは皆にとって非常に役立つでしょう。

「いいね!」 6

できますが、いくつか推測になるでしょう!

「いいね!」 2

関連トピックで、カレンダーとイベントのトピックをリフレッシュしていたところ、これを見つけました(関連トピックのもう1つの勝利です :slight_smile: :medal_sports:

両方の機能が1つのプラグイントピックとして正しく表示されるように再編成しました。これにより、混乱が解消されることを願っています。

また、「ハウツー」の詳細の多くをいくつかのガイドに分割し、余裕を持たせました。

主な焦点は、より一貫した構造を与えることでした(念のため、簡単なリフレッシュも追加しました)。それらをスムーズにするのは少し骨が折れましたが、以前よりも良い状態になったと思います。一晩寝て考えた結果、まだいくつかやりたいことがあるので、まだ :rocket: を出す準備はできていません。 :slight_smile:

しかし、正しい方向に向かっていることを願っています。 :crossed_fingers: :slight_smile:

「いいね!」 7