Skip to content

Refresh branding#105

Merged
ryanlua merged 47 commits intomainfrom
refresh-branding
Aug 26, 2025
Merged

Refresh branding#105
ryanlua merged 47 commits intomainfrom
refresh-branding

Conversation

@ryanlua
Copy link
Owner

@ryanlua ryanlua commented Aug 26, 2025

Description

Refreshes the project branding to be easier to maintain and cleaner.

General

  • Remove horizontal logos
  • Optimize Satchel logo and icon
  • Recompress all files with Oxipng

Docs website

  • Move from satchel.ryanluu.dev to satchel.luau.page domain
  • Switch docs to Material for MkDocs Insiders
  • Remove Google Analytics
  • Fix dev container
  • Remove markdownlint tooling
  • Move assets into docs assets
  • Add sponsors section to home
  • Add Purse and remove old systems from alternatives
  • Remove PWA support (no one uses this)
  • Fix incorrect slot number for platforms
  • Remove SEO metadata
  • Make line numbers global
  • Remove dead code samples
  • Remove contributing, benchmark, and sponsor pages
  • Simplify installation page
  • Update links to use link references
  • Add playground experience to footer
  • Remove extra features from MkDocs configuration
  • Enable mike for doc versions
  • Remove 3rd party plugins

GitHub Readme

  • Update license notice
  • Remove features, acknowledgements, playground, support, and installation sections
  • Add sponsors section
  • Update documentation section
  • Simplify shield badges
  • Rename CI workflow
  • Remove Download and Open in GitHub Codespaces badges

Related Issues

Changes Made

This pull request focuses on streamlining documentation, improving workflows, and updating branding and sponsorship information for Satchel. The most significant changes include major updates to the documentation workflow, README reorganization, and removal of markdown linting configuration. Additionally, there are improvements to dev environment setup and branding consistency.

Documentation and Workflow Improvements:

  • Refactored .github/workflows/documentation.yml to simplify deployment, improve caching, and switch to direct deployment using mkdocs gh-deploy. Updated permissions and branch/path filters for more precise triggering.
  • Removed .github/workflows/markdown.yml and deleted .markdownlint.json, discontinuing automated markdown linting in CI. [1] [2]

Branding and Sponsorship Updates:

  • Updated README.md to use new badges, reorganized sections for clarity, added a sponsors section, and updated documentation links to satchel.luau.page. [1] [2]
  • Changed documentation CNAME from satchel.ryanluu.dev to satchel.luau.page for consistent branding.

Dev Environment and Miscellaneous:

  • Updated .devcontainer/devcontainer.json to install mike alongside mkdocs-material for documentation versioning support.
  • Adjusted recommended VSCode extensions, replacing vscode-markdownlint with vscode-yaml for YAML editing.
  • Minor updates to documentation files for clarity and improved links (e.g., docs/alternatives.md, docs/api-reference.md). [1] [2] [3] [4]

Checklist

  • I have tested these changes thoroughly.
  • I have reviewed my code for any potential errors or issues.
  • I have followed the code style guidelines for this project.
  • Fix mike

Additional Notes

ryanlua added 30 commits July 31, 2025 22:49
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
ryanlua added 13 commits August 25, 2025 19:54
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: Ryan Luu <ryan.luu@ryanluu.dev>
Signed-off-by: Ryan Luu <ryan.luu@ryanluu.dev>
@ryanlua ryanlua added the documentation Improvements or additions to documentation label Aug 26, 2025
Signed-off-by: GitHub <noreply@github.com>
Signed-off-by: Ryan Luu <ryan.luu@ryanluu.dev>
@ryanlua ryanlua marked this pull request as ready for review August 26, 2025 08:47
@ryanlua ryanlua requested a review from Copilot August 26, 2025 08:47
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR modernizes Satchel's branding and streamlines its documentation infrastructure. The changes focus on updating the project's visual identity, simplifying the build process, and consolidating documentation resources.

  • Updates branding elements including logos, favicons, and documentation URLs from satchel.ryanluu.dev to satchel.luau.page
  • Streamlines documentation workflow by removing markdown linting and simplifying the MkDocs deployment process
  • Reorganizes and updates documentation content with improved formatting and updated links

Reviewed Changes

Copilot reviewed 22 out of 59 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
README.md Simplified layout with new branding, added sponsors section, and updated badges
mkdocs.yml Major configuration cleanup removing analytics, feedback systems, and unused features
docs/index.md Updated homepage with new sponsor section and simplified feature grid
docs/assets/ New logo and favicon assets with consistent branding
.github/workflows/ Removed markdown linting workflow and simplified documentation deployment
docs/usage.md, docs/installation.md Updated with improved link formatting and content organization
Comments suppressed due to low confidence (1)

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

@ryanlua ryanlua marked this pull request as draft August 26, 2025 08:49
Signed-off-by: GitHub <noreply@github.com>
@ryanlua ryanlua self-assigned this Aug 26, 2025
@ryanlua ryanlua marked this pull request as ready for review August 26, 2025 09:11
@ryanlua ryanlua merged commit 39adcc7 into main Aug 26, 2025
2 checks passed
@ryanlua ryanlua deleted the refresh-branding branch August 26, 2025 09:12
@ryanlua ryanlua added this to the v1.4.0 milestone Sep 2, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants