alunduil / alunduil/blog.alunduil.com

Short-form note posts have a defined format and convention

未關閉
#321 0 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視
enhancement
主要語言
Astro
星號
1
分支
1
平均合併
6 小時 34 分鐘
30 天內合併 PR
118

描述

## Summary

Define how a short-form note post reads, where it lives, and how it differs from a longer post in the feeds — the foundation the note syndication and drafting work builds on.

## Motivation

`shape: note` exists in the schema as of #598, so a note is already identifiable. What's still missing is the convention around it: nothing decides how a note carries a page title, where the file lives, or whether it appears in the main feed. `rss.xml` still maps every post to the same title+link item. The full-body syndication and drafting work both need those settled. #191 is the first note and is held pending this.

## Scope

- Resolve the title tension: AstroPaper requires `title`, and a note reads as titleless. Decide how a note carries a page title, and whether that title appears in syndication.
- Decide the note location under `src/data/blog/`. Note that directories are URLs here — `getPath` keeps every non-underscore path segment — so a `notes/` directory would put `/posts/notes/` in the permalink.
- Decide whether notes appear in the main `rss.xml` (title+link) or are excluded in favour of the notes feed (see #322).
- Establish the note format convention an author fills in.

## Acceptance criteria

- [x] A post is unambiguously identifiable as a note — `shape: note`, wired into `content.config.ts` (#598).
- [ ] The note title convention is documented.
- [ ] Main-feed membership for notes is decided and implemented.
- [ ] The convention is documented in `docs/reference/post-shapes.md`.

## Additional context

- Enables #322 (full-body syndication) and #323 (the note-draft skill).
- First note: #191.

貢獻指南

這個儲存庫沒有索引到貢獻指南

評估

這個 Issue 還沒有評估資料。

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。