Skip to content

Conversation

@bracevac
Copy link
Contributor

@bracevac bracevac commented Nov 25, 2025

This is in preparation to unfsck the SIP page

  • Remove "SIP-XX - " prefix from all SIP/SID titles
  • Add number: XX field to YAML frontmatter for each SIP
  • Old SIDs are marked with kind: SID in the YAML.
  • Rename SIP files to include their number in their file name.

These changes should help in achieving a decent sorting in Jekyll.

@bracevac bracevac changed the title Extract SIP numbers from titles into separate YAML field Clean up the SIP files Nov 26, 2025
@bishabosha bishabosha self-requested a review November 26, 2025 13:07
- Remove "SIP-XX - " prefix from all SIP titles
- Add 'number: XX' field to YAML frontmatter for each SIP
- Leave SID (Scala Improvement Document) files unchanged
It's in preview mode now, thus shipped.
@bracevac
Copy link
Contributor Author

PR for website changes: scala/docs.scala-lang#3236

@bracevac bracevac merged commit 88cd07c into scala:main Nov 28, 2025
bracevac added a commit to scala/docs.scala-lang that referenced this pull request Dec 1, 2025
Revamp the SIPs section of the documentation site

- **Title rendering**: The page title now dynamically renders as "SIP-XX - Title" by combining the `number` and `title` YAML fields (supports optional `kind` field for SID variants)
- **Simplified listing page**: `_sips/all.md` now only lists completed SIPs, with links to GitHub for pending/rejected/withdrawn proposals
- **Automated sync**: Added GitHub Action (`.github/workflows/sync-sips.yml`) that syncs SIP content daily from [scala/improvement-proposals](https://github.com/scala/improvement-proposals) and creates a PR if there are changes

### Changes
- `_layouts/root-content-layout.html`: Conditional title rendering for SIP pages
- `_sips/all.md`: Simplified structure, sorted by number descending.
- `.github/workflows/sync-sips.yml`: New workflow for automated content sync
- `_sips/sips/`: SIP files in sync with change set of scala/improvement-proposals#120, removed files for non-completed SIPs.
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