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

Add a manual live-server smoke test suite

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

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
30/100
issue の種類
機能追加
明瞭さ
説明が足りない
活発さ
活発
技術スタック
go
領域
cli, testing-qa

調査の方向性

docs/confluence/ と既存の golden および --json のテストカバレッジから始め、どのライブ Confluence の挙動がテストされていないかを把握します。ページ幅、添付ファイルの同期、受け入れられる添付ファイル名、公開されたテーブルのレンダリングを対象とする、手動で呼び出す最小限のスイートを定義します。完了条件は、呼び出し方法、認証情報と個人スペースの扱い、ガードレール、クリーンアップ、アサーション、および go test ./... と CI からの除外が明記されていることです。

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

説明

enhancement

Add a test suite a developer runs by hand against a real Confluence server —
credentials from the usual CONFLUENCE_* resolution, pages created in a personal
space — covering a small, critical set of behaviour.

Why

The current suite proves what markfluence emits: the converter's goldens pin the
storage format, and the --json schema guards the output contract. Neither can
prove what Confluence does with what we send, and docs/confluence/
is explicit that this is where confident wrong conclusions come from — body.storage
shows only what was stored, never what takes effect. Several behaviours were
established by experiment and are currently protected by nothing but those notes:

  • page width living in two content properties, where writing one leaves the reader
    and the editor disagreeing;
  • attachment sync's checksum/recorded-path logic (skip, update, repair a mangled
    path) and the multipart charset requirement;
  • what attachment names Confluence accepts;
  • whether a published table keeps its layout, alignment, and highlight colours.

A suite that runs against a live server would turn those from documented
observations into something re-checkable when Atlassian changes behaviour.

Deliberately undecided

Nothing about the design is settled yet — to be worked out when this is picked up:

  • what it covers (which commands, which round trips, how minimal is minimal)
  • how it is invoked and how it is kept out of go test ./... and CI
  • how the target space and credentials are supplied
  • what guardrails and cleanup it needs, given it writes real pages
  • where the files live and what they assert against

Notes

Came up while fixing #18. Not urgent — parked for now.

主要言語
Go
スター
2
フォーク
0
平均マージ
2時間 50分
マージ済み PR(30日)
52

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

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

mozilla/markfluence のほかの issue

mozilla/markfluence の issue をすべて見る

似ている issue

Go の issue をもっと見る

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

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