diff --git a/README.md b/README.md index fdb0260..3a1d251 100644 --- a/README.md +++ b/README.md @@ -36,6 +36,10 @@ CI validates links/content and builds VitePress on pull requests. The Pages work See [CONTRIBUTING.md](CONTRIBUTING.md). Please propose focused changes backed by compiler implementation or tests. +## Official community channels + +The [community page](docs/community/social.md) lists Scarp's verified public GitHub, X, YouTube, Instagram, Threads, and Bluesky profiles, plus the public contact address. Navigation icons link directly to those channels. Do not add unverified social handles or link personal developer profiles as official Scarp accounts. + ## Compiler-backed conformance checks The `conformance/` directory contains seven pinned source/output pairs copied from the released Scarp compiler examples. To verify fixture integrity locally (does not require Rust): diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index 9fec5b0..457720f 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -46,13 +46,25 @@ export default defineConfig({ outline: { level: [2, 3], label: 'On this page' }, docFooter: { prev: 'Previous', next: 'Next' }, editLink: { pattern: `${docsRepo}/edit/main/docs/:path`, text: 'Improve this page on GitHub' }, - socialLinks: [{ icon: 'github', link: sourceRepo }], + // Public Scarp accounts verified against their published profile descriptions. + // Add other platforms only after confirming their exact official URLs. + socialLinks: [ + { icon: 'github', link: 'https://github.com/scarp-lang', ariaLabel: 'Scarp on GitHub' }, + { icon: 'x', link: 'https://x.com/ScarpLang', ariaLabel: 'Scarp on X' }, + { icon: 'youtube', link: 'https://www.youtube.com/@ScarpLang', ariaLabel: 'Scarp on YouTube' }, + { icon: 'instagram', link: 'https://www.instagram.com/scarplang/', ariaLabel: 'Scarp on Instagram' }, + { icon: 'bluesky', link: 'https://bsky.app/profile/scarplang.bsky.social', ariaLabel: 'Scarp on Bluesky' }, + { icon: 'threads', link: 'https://www.threads.net/@scarplang', ariaLabel: 'Scarp on Threads' } + ], nav: [ { text: 'Guide', link: '/guide/installation' }, { text: 'Language', link: '/language/overview' }, { text: 'CLI', link: '/tooling/cli' }, { text: 'Examples', link: '/examples/' }, - { text: 'Contributing', link: '/community/contributing' }, + { text: 'Community', items: [ + { text: 'Official channels', link: '/community/social' }, + { text: 'Contributing', link: '/community/contributing' } + ] }, { text: 'v0.0.5-alpha.1', items: [ { text: 'Feature status', link: '/reference/status' }, { text: 'Compiler releases', link: `${sourceRepo}/releases` } @@ -92,6 +104,7 @@ export default defineConfig({ ] }, { text: 'Learn and contribute', items: [ { text: 'Verified examples', link: '/examples/' }, + { text: 'Official social channels', link: '/community/social' }, { text: 'Contributing', link: '/community/contributing' }, { text: 'Docs maintainer checklist', link: '/project/maintenance' } ] } diff --git a/docs/community/social.md b/docs/community/social.md new file mode 100644 index 0000000..9f4571a --- /dev/null +++ b/docs/community/social.md @@ -0,0 +1,24 @@ +# Connect with Scarp + +Follow the official **Scarp Programming Language** accounts for project announcements, compiler updates, tutorials, and community news. The links below were checked against public profiles identifying themselves as Scarp's accounts on **November 1, 2026**. + +| Platform | Official Scarp account | What you can find | +| --- | --- | --- | +| GitHub | [scarp-lang](https://github.com/scarp-lang) | Compiler source, documentation, issues, and releases | +| X | [@ScarpLang](https://x.com/ScarpLang) | Short development and release updates | +| YouTube | [Scarp Programming Language](https://www.youtube.com/@ScarpLang) | Official video channel for upcoming compiler demonstrations and tutorials | +| Instagram | [@scarplang](https://www.instagram.com/scarplang/) | Scarp project profile and visual updates | +| Threads | [@scarplang](https://www.threads.net/@scarplang) | Scarp project profile and community posts | +| Bluesky | [@scarplang.bsky.social](https://bsky.app/profile/scarplang.bsky.social) | Scarp project profile and development updates | + +Accounts may not have published posts yet; an account being listed here does **not** imply that content or a feature has already been released. + +## Get help and contribute + +For a compiler bug or a language feature discussion, use the [compiler issue tracker](https://github.com/scarp-lang/scarp/issues). For mistakes in these docs, use the [documentation issue tracker](https://github.com/scarp-lang/scarp-docs/issues) or [contribute a correction](/community/contributing). + +For project correspondence, contact [scarplang@gmail.com](mailto:scarplang@gmail.com). The address is published by the official Scarp YouTube channel. + +## Keep the links accurate + +Before adding a new social channel, confirm its profile is publicly accessible and identifies the Scarp Programming Language project. Do not link unverified lookalike accounts or assume a handle is available simply because the name matches. In particular, a public Discord invitation, Facebook page URL, or LinkedIn company page URL is not listed here until its official destination is confirmed. diff --git a/docs/index.md b/docs/index.md index 8e1c99d..0eaa7c1 100644 --- a/docs/index.md +++ b/docs/index.md @@ -35,6 +35,9 @@ features: - title: Developer-friendly navigation details: Local search, code highlighting, accessible mobile navigation, and light/dark appearances. link: /guide/first-program + - title: Official Scarp community + details: Find the project's verified social channels, news, and ways to contribute. + link: /community/social --- ::: warning Experimental language