Skip to content
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions docs/en/05-implementation/03-secure-libraries/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,11 @@
within the SAMM [Security Architecture][sammdsa] security practice
which in turn is part of the [Design][sammd] business function.

## Recommended Secure Libraries (OWASP Projects)
Copy link

Copilot AI Jan 15, 2026

Choose a reason for hiding this comment

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

The section title 'Recommended Secure Libraries (OWASP Projects)' is ambiguous since all libraries in this section (ESAPI, CSRFGuard, OSHP) are OWASP projects. Consider a more specific title that clarifies this is a quick reference list, or reconsider whether a separate section is needed given that dedicated pages exist for other libraries.

Suggested change
## Recommended Secure Libraries (OWASP Projects)
## Quick Reference: OWASP Secure Libraries

Copilot uses AI. Check for mistakes.

- **OWASP Java Encoder**https://owasp.org/www-project-java-encoder/

Check failure on line 13 in docs/en/05-implementation/03-secure-libraries/index.md

View workflow job for this annotation

GitHub Actions / Lint markdown

Bare URL used

docs/en/05-implementation/03-secure-libraries/index.md:13:28 MD034/no-bare-urls Bare URL used [Context: "https://owasp.org/www-project-..."] https://github.com/DavidAnson/markdownlint/blob/v0.40.0/doc/md034.md
- **OWASP Java HTML Sanitizer**https://owasp.org/www-project-java-html-sanitizer/

Check failure on line 14 in docs/en/05-implementation/03-secure-libraries/index.md

View workflow job for this annotation

GitHub Actions / Lint markdown

Bare URL used

docs/en/05-implementation/03-secure-libraries/index.md:14:35 MD034/no-bare-urls Bare URL used [Context: "https://owasp.org/www-project-..."] https://github.com/DavidAnson/markdownlint/blob/v0.40.0/doc/md034.md
Comment on lines +13 to +14
Copy link

Copilot AI Jan 15, 2026

Choose a reason for hiding this comment

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

The documentation uses markdown reference-style links consistently throughout (see lines 23-25 for examples). Direct URLs should be converted to reference-style links following the pattern used elsewhere in the file. For example, define [java-encoder] and [java-sanitizer] at the bottom of the file and use them in the list items.

Copilot uses AI. Check for mistakes.

Comment on lines +11 to +15
Copy link

Copilot AI Jan 15, 2026

Choose a reason for hiding this comment

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

This section presents libraries differently from the established pattern in this documentation. Other libraries (ESAPI, CSRFGuard, OSHP) have dedicated pages with detailed sections explaining 'What is it?', 'Why use it?', and 'How to use it?'. Consider either creating dedicated pages for these libraries following the same pattern, or removing this section since these libraries are already mentioned in the ESAPI page (line 27-28 of 01-esapi.md) as alternatives.

Suggested change
## Recommended Secure Libraries (OWASP Projects)
- **OWASP Java Encoder**https://owasp.org/www-project-java-encoder/
- **OWASP Java HTML Sanitizer**https://owasp.org/www-project-java-html-sanitizer/

Copilot uses AI. Check for mistakes.
----

The OWASP Developer Guide is a community effort; if there is something that needs changing
Expand Down
Loading