Dartdoc: サードパーティパッケージからapi.dartlang.orgのSDK内の識別子へのリンク

作成日 2015年07月28日  ·  8コメント  ·  ソース: dart-lang/dartdoc

SDKの識別子(たとえば、 List )へのリンクをサポートします。 リンクは、(class-、method-、...)シグニチャおよびドキュメントコメント(マークアップリンク)のタイプに追加する必要があり

P1 customer angular enhancement help wanted

全てのコメント8件

これに関する更新はありますか? トリアージして優先度レベル、たとえばP1でマークすることはできますか:)

@devoncarewまだdartdocに取り組んでいる人がいますか?

@keertipはそれに取り組んでいますが、それは彼女の主な仕事ではありません。 貢献はここで歓迎されています。

@ devoncarew-更新していただきありがとうございます。 少なくともこの問題に優先度を割り当てることはできますか?
そして多分それを助けが必要なものとしてタグ付けしますか?

これは、api.dartlang.orgへの外部リンクのリクエストですか、それともこれを行うためのauto-include-dependenciesのリクエストですか?

前者だと思います。

デフォルトでは、SDKクラスを使用してSDKドキュメントにリンクする外部生成APIドキュメントのリクエストだと思います。 たとえば、外部パッケージ(たとえば、 args )にマップ(たとえば、コマンド)であるプロパティがある場合、ほとんどの人は、マップをクリックしてhttps://api.dartlang.org/stable/dart-coreにアクセスできるようにしたいと思うでしょう

オプションは、(1)それらのリンクを生成しないか、(2)SDKAPIドキュメントの特定のバージョンにリンクすることです。 これらのリンクは、おそらく同じパッケージ内のリンクとは異なるデフォルトのフォーマットを持つ必要があります。

わかった。 #1368は後者に対処しましたが、前者は間違いなく私のレーダーにあります。 問題のタイトルをより明確にするために調整します。

1524はこれをはるかに簡単にするはずです。 Dartdocには、代替ハイパーリンクを生成する必要があるかどうかを判断するために使用できる基本的なパッケージ境界認識が含まれているため、生成を実装するだけで済みます。

このページは役に立ちましたか?
0 / 5 - 0 評価