Skip to content

docs: Wiki をリポジトリ内 docs で管理する - #402

Merged
a01sa01to merged 11 commits into
mainfrom
docs/wiki-to-docs
Oct 29, 2026
Merged

a01sa01to merged 11 commits into
mainfrom
docs/wiki-to-docs

Conversation

@a01sa01to

@a01sa01to a01sa01to commented Oct 27, 2026 •

Copy link
Copy Markdown
Member

Wiki は編集が楽だが IdP のバージョンごとに管理できないのがちょっと辛いかも

マージ後 Wiki は消す予定です

長い README.md もいくつかに分割して docs 配下に置いてもよいかもしれない

ところで biome で markdown 対応したんですね

@a01sa01to a01sa01to self-assigned this Oct 27, 2026
@a01sa01to a01sa01to changed the title docs: Wiki を docs に変換 docs: Wiki をリポジトリ内 docs で管理する Oct 27, 2026

@kosumo77 kosumo77 left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

更新でwikiの変更が必要なところをまとめました。

Comment thread docs/oauth/resource-endpoints.md Outdated
Comment on lines +9 to +10
- URL の prefix として `https://id.maximum.vc/oauth/resources` をつけてください
- 例えば、 `GET /authuser` なら `https://id.maximum.vc/oauth/resources/authuser` に GET を投げてください

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

https://id.maximum.vc/oauth/resourcesの部分がhttps://api.id.maximum.vc/oauth/resourcesになると思います

Suggested change
- URL の prefix として `https://id.maximum.vc/oauth/resources` をつけてください
- 例えば、 `GET /authuser` なら `https://id.maximum.vc/oauth/resources/authuser` に GET を投げてください
- URL の prefix として `https://api.id.maximum.vc/oauth/resources` をつけてください
- 例えば、 `GET /authuser` なら `https://api.id.maximum.vc/oauth/resources/authuser` に GET を投げてください

Comment thread docs/dev/routes.md Outdated
これらのパスは開発時にのみ利用可能です。
Preview, Production 環境では利用できません。

## `/dev/cron`

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/cronの方に移っているはずなのでそこに合わせた方がいいと思います

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

そもそも Cron Trigger の query parameter で cron=0+*+*+*+* みたいに実行時間指定する方式やめて実行処理名叩く方式になったので、もはや便利機能じゃないから docs から消しちゃっていいな

Comment thread docs/oauth/index.md Outdated
iat: number, // 発行日時
at_hash: string, // Access Token のハッシュ
nonce?: string, // Authorization Endpoint に渡された nonce
authTime?: number, // ユーザーの最終認証日時

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

signJWTに含むpayloadに使っているのはauth_timeなのでこの部分authTimeではなくてauth_timeだと思います

Suggested change
authTime?: number, // ユーザーの最終認証日時
auth_time?: number, // ユーザーの最終認証日時

Comment thread docs/oauth/index.md Outdated

// email scope が存在している場合に含まれる情報
email?: string, // 連絡の取れるメールアドレス
email_verified: boolean, // false (現状固定)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

#382 からread:rolesが追加されたので追加してもいいんじゃないかなぁと思います

Suggested change
email_verified: boolean, // false (現状固定)
email_verified: boolean, // false (現状固定)
// read:roles scope が存在している場合に含まれる情報
roles?: string[], // ユーザーに割り当てられている Role slug (admin, member, accountant, ...)

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

resource-endpoints.md があるのでこっち参照してねでいい気がするな

Comment thread docs/oauth/errors.md Outdated
Comment on lines +151 to +154
#### invalid_request: Authorization header is not allowed

`Authorization: foo` がリクエストヘッダに付与されています。
外してください。

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

#319 で Authorization header is not allowedがMissing client_id or client_secretに代わっているのでそれに合わせる形で更新が必要そうです。
またInvalid Authorization Header が追加されているのでこちらもです。

Suggested change
#### invalid_request: Authorization header is not allowed
`Authorization: foo` がリクエストヘッダに付与されています。
外してください。
#### invalid_request: Missing client_id or client_secret
POST body に `client_id`, `client_secret` が含まれておらず、リクエストヘッダにも `Authorization: Basic <token>` が付与されていないようです。
どちらかの方法で指定してください。
#### invalid_request: Invalid Authorization Header
リクエストヘッダの `Authorization: Basic <token>` の形式がおかしいみたいです。
`<client_id>:<client_secret>` を Base64 エンコードしたものを指定しているか確認してください。

@a01sa01to

Copy link
Copy Markdown
Member Author

よく見てらっしゃる、えらい

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 28, 2026 •

Copy link
Copy Markdown

Deploying id with  Cloudflare Pages  Cloudflare Pages

Latest commit: aafbba6
Status: ✅  Deploy successful!
Preview URL: https://297685b6.id-131.pages.dev
Branch Preview URL: https://docs-wiki-to-docs.id-131.pages.dev

View logs

@a01sa01to
a01sa01to requested a review from kosumo77 October 28, 2026 14:32
@a01sa01to
a01sa01to merged commit feb9de7 into main Oct 29, 2026
8 checks passed
@a01sa01to
a01sa01to deleted the docs/wiki-to-docs branch October 29, 2026 05:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants