LuaLS / LuaLS/lua-language-server

[Feature Request] Allow passing filters to `--doc`

Offen
#2,630 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Vorherrschende Sprache
Lua
Sterne
4.4k
Forks
442
PR-Merge-Kennzahlen
Keine gemergten PRs in 30 T.

Beschreibung

It would be very nice if we were able to pass filters to the --doc command to only document specific namespaces.

Example:

lua-language-server --doc="../../.." --doc-filter="MyNameSpace" --doc_out_path="."

Would only output documentation for MyNameSpace and every member like MyNameSpace.Private etc.

For the json output formal I can do this easily via something like

jq '[.[] | select(.name | index("MyNameSpace") != -1)]' doc.json > output.json but for the markdown output, it would be fairly difficult.

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Beginne beim --doc-Befehl und vergleiche, wie markdown- und JSON-Dokumentation generiert werden. Verfolge den bestehenden Dokumentationsausgabepfad und ermittle anschließend, an welcher Stelle ein --doc-filter-Wert einen Namespace und seine Member begrenzen kann. Erledigt ist es, wenn die gefilterte markdown- und JSON-Ausgabe ausschließlich den angeforderten Namespace-Bereich enthält.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
lua
Bereich
cli, documentation
Issue-Typ
Feature
Schwierigkeit
3/5
Geschätzter Aufwand
1-2 Tage
Aktivitätsstatus
Veraltet
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
42/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.