Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Add comprehensive developer docs

オープン
#171 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

@AdrianAtZyte がすでに取り組んでいます。

2026年8月21日 から。

  • #184 @AdrianAtZyte による — オープン

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
48/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
静か
技術スタック
python
領域
documentation

調査の方向性

まず GenericTranslator と既存のテストを読んで、CSS の機能と translator メソッドの対応関係を整理し、セレクター入力から XPath 出力までの流れを理解します。開発者向けドキュメントでこれらの対応関係とロジックの流れを説明し、さらにサポート状況の表と、テストと整合した手書きの例を含めれば完了です。

索引モデルが issue の本文から書いたものです。

説明

documentation enhancement

I think the codebase is not really suitable for reading and editing as it is now, as a minimum I would want a table and/or docstrings for mapping CSS features to GenericTranslator methods and back and a doc about the logic flow between the CSS selector input and the XPath result. It would also be nice to have (if possible and not too unwieldy) a table(s) listing all features of CSS3/4 and marking which are supported, not implemented or can't be implemented, and some kind of table of a manually written examples covering all features we support (like the tests but more comprehensive, and hopefully synced with them).

主要言語
Python
スター
311
フォーク
73
平均マージ
17時間 34分
マージ済み PR(30日)
18

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

scrapy/cssselect のほかの issue

scrapy/cssselect の issue をすべて見る

似ている issue

Python の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。