Initial Bouncy Castle Migration Guide#251
Merged
padelsbach merged 1 commit intowolfSSL:masterfrom Feb 13, 2026
Merged
Conversation
There was a problem hiding this comment.
Pull request overview
Adds an initial English “Bouncy Castle Migration Guide” to the documentation build system, including a new make target to generate PDF/HTML output alongside existing manuals.
Changes:
- Add
BouncyCastle-Migration/manual (MkDocs + Pandoc header + chapters 1–8). - Wire the new manual into the root build (
make bc-migrationandmake all) and README build list. - Provide migration guidance for JCE/JSSE usage, FIPS considerations, troubleshooting, and support.
Reviewed changes
Copilot reviewed 13 out of 13 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| README.md | Documents the new make bc-migration build target. |
| Makefile | Adds bc-migration target and includes it in all. |
| BouncyCastle-Migration/Makefile | Defines sources and output PDF name for the new manual. |
| BouncyCastle-Migration/mkdocs.yml | MkDocs config and navigation for the migration guide site build. |
| BouncyCastle-Migration/header.txt | Pandoc PDF header customization for page breaks/headers/code wrapping. |
| BouncyCastle-Migration/src/chapter01.md | Introduction, audience, scope, and motivation. |
| BouncyCastle-Migration/src/chapter02.md | High-level differences between BC and wolfSSL Java providers. |
| BouncyCastle-Migration/src/chapter03.md | JCE provider migration and WKS KeyStore migration guidance. |
| BouncyCastle-Migration/src/chapter04.md | JSSE provider migration guidance. |
| BouncyCastle-Migration/src/chapter05.md | Proprietary BC API migration examples (cert extensions, SANs, RSA, utilities). |
| BouncyCastle-Migration/src/chapter06.md | FIPS 140-3 considerations for wolfJCE/wolfJSSE usage. |
| BouncyCastle-Migration/src/chapter07.md | Troubleshooting and common migration issues. |
| BouncyCastle-Migration/src/chapter08.md | Support channels and related documentation links. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
cconlon
force-pushed
the
bcMigrationGuide
branch
from
1d88be4 to
dad20f1
Compare
padelsbach
previously approved these changes
Feb 13, 2026
cconlon
force-pushed
the
bcMigrationGuide
branch
from
dad20f1 to
712a3b4
Compare
padelsbach
approved these changes
Feb 13, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR adds an initial Bouncy Castle Migration guide (English).
Creates HTML and PDF output:
Current content outline: