Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Nov 8, 2025

Description of Change

Migrated all SkiaSharp wiki documentation into the source repository under documentation/ for version control, community contributions, and synchronization with code changes.

Structure Created:

  • documentation/user-guide/ - Platform support, Linux assets, Python integration (3 docs)
  • documentation/building/ - Build instructions, Linux builds, library creation (3 docs)
  • documentation/contributing/ - Contribution guide, issue submission, doc writing (3 docs)
  • documentation/maintainer/ - Release process, versioning, branching strategy (5 docs)
  • documentation/archived/ - Legacy content preserved for reference (1 doc)

Content Updates:

  • Modernized build dependencies (.NET 8.0.304+, VS 2022, Android NDK r25+, Xcode 15.4)
  • Updated .NET platform support to accurately reflect .NET 6, 7, 8, 9 (verified against source code)
  • Added .NET MAUI and WinUI 3 to platform support matrix
  • Enhanced Linux build guide with Docker examples
  • Created comprehensive navigation READMEs with "I want to..." patterns
  • Added WIKI_MIGRATION.md mapping wiki pages to new locations
  • Verified all versions and platforms against actual build configuration (azure-templates-variables.yml)

Files:

  • 17 new documentation files (2,130 lines)
  • Updated root README.md to reference documentation/ structure with accurate .NET versions
  • Preserved docs/ submodule for API documentation
  • Preserved design/ for architecture documentation

Migration mapping: All 16 relevant wiki pages migrated. WIP Changelog excluded (outdated). Original wiki can be deprecated with notice.

Bugs Fixed

None.

API Changes

None.

Behavioral Changes

None.

Required skia PR

None.

PR Checklist

  • Has tests (if omitted, state reason in description) - Documentation only, no code changes
  • Rebased on top of main at time of PR
  • Merged related skia PRs - N/A
  • Changes adhere to coding standard
  • Updated documentation - This IS the documentation update
Original prompt

Can you clone https://github.com/mono/SkiaSharp.wiki.git and see what docs exist there.

Maybe this content can be used to augment the current docs.

First validate them, and then see where they fit.

The goal is to move the docs out of the wiki into source. Please move all the docs. If there are incorrect, first fix and then add.

Maybe the wiki will fit into existing docs, but it is also likely that new docs will have to be added.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI and others added 3 commits November 8, 2025 13:53
- Created comprehensive docs directory structure
- Migrated all wiki pages to appropriate sections
- Updated Views Support Matrix with .NET MAUI support
- Updated building guides with latest tools and dependencies
- Created new main docs README with navigation
- Updated root README to reference new docs structure

Co-authored-by: mattleibow <[email protected]>
All documentation from the wiki has been successfully migrated:
- Created documentation/ directory structure (user-guide, building, contributing, maintainer, archived)
- Migrated 17 wiki pages with updates for modern tooling
- Updated Views Support Matrix with .NET MAUI support
- Updated building guides with .NET 8, VS 2022, latest dependencies
- Created comprehensive documentation README with navigation
- Updated root README to reference new documentation structure
- Fixed all cross-references between docs
- Preserved archived legacy documentation

Co-authored-by: mattleibow <[email protected]>
Added comprehensive mapping document showing:
- Original wiki page to new location mapping
- Structural changes and improvements
- Content updates and modernizations
- Instructions for accessing and contributing

Co-authored-by: mattleibow <[email protected]>
Copilot AI changed the title [WIP] Move documentation from wiki to source repository Migrate wiki documentation to source repository Nov 8, 2025
Copilot AI requested a review from mattleibow November 8, 2025 14:00
Copilot finished work on behalf of mattleibow November 8, 2025 14:00
@mattleibow
Copy link
Contributor

@copilot please go the the documentation and make sure it is accurate and the things match what is supported. Versions, platforms and sdks have changed over time, so check all. Just because there is docs that says something does not mean it is still true.

1 similar comment
@mattleibow
Copy link
Contributor

@copilot please go the the documentation and make sure it is accurate and the things match what is supported. Versions, platforms and sdks have changed over time, so check all. Just because there is docs that says something does not mean it is still true.

- Updated .NET support from "6" to "6, 7, 8, 9" in README
- Updated Xcode requirement from "14+" to "15.4" or later
- Updated .NET SDK requirement with specific version (8.0.304+ recommended)
- Verified all platform support information matches actual source code
- All version numbers now match azure-templates-variables.yml

Co-authored-by: mattleibow <[email protected]>
Copy link
Contributor Author

Copilot AI commented Nov 8, 2025

@copilot please go the the documentation and make sure it is accurate and the things match what is supported. Versions, platforms and sdks have changed over time, so check all. Just because there is d...

Done! I've verified all documentation against the actual source code and build configuration. Updated in commit 90adf3b:

Corrected versions:

  • .NET support: Changed from just ".NET 6" to ".NET 6, 7, 8, 9" (verified in UtilsManaged.cake)
  • Xcode: Updated from "14+" to "15.4 or later" (per azure-templates-variables.yml)
  • .NET SDK: Specified 8.0.304+ recommended (per DOTNET_VERSION in build config)

Verified accurate:

  • Android platform versions (21-34)
  • Python 3.x requirement
  • Visual Studio 2022
  • All platform support (MAUI, WinUI 3, etc.)
  • View packages and controls

All version numbers now match the actual build requirements in scripts/azure-templates-variables.yml.

Copilot finished work on behalf of mattleibow November 8, 2025 17:48
Copilot finished work on behalf of mattleibow November 8, 2025 17:54
Base automatically changed from dev/ai to main November 13, 2025 03:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

2 participants