microsoft/language-server-protocol

Describe high-level concepts in the specifications page

Open

#881 opened on 2019年12月19日

GitHub で見る
 (1 comment) (0 reactions) (0 assignees)HTML (12,810 stars) (956 forks)batch import
clarificationcode lenshelp wanted

説明

The specification page mentions some concepts without introducing the concepts themselves.

For example, in the Code Lens Request section:

The code lens request is sent from the client to the server to compute code lenses for a given text document.

As a language server implementor I'm not necessarily familiar with these concepts, so a high-level explanation (or a link to a place where these concepts are described) and an example would help.

コントリビューターガイド

技術スタック
なし
領域
documentation
Issue 種別
documentation
難度新しい貢献者にとっての実装難度です。1 は非常に小さな変更、5 は専門的な作業です。
3
推定時間経験ある貢献者が調査、実装、テスト、pull request 準備にかけるおおよその時間範囲です。
half day
活動状況Issue が今どれだけ取り組みやすいかを示します。新しい、活発、古い、ブロック中、またはメンテナー入力待ちなどです。
stale
明確さ期待される変更、受け入れ条件、次の手順がどれだけ明確かを示します。
clear
前提条件
Basic understanding of LSPDocumentation writing skills
初心者向け度初回貢献者にどれだけ取り組みやすいかを 1-100 で推定したスコアです。
60
調査方針
Review the specification document to identify sections where concepts are introduced without explanation. For each such concept, draft a brief high level explanation and include an example. Consider linking to external resources for further reading. Ensure the additions follow the existing documentation style.