Contribute: Documentation

Documentation is very important, and while we have tried to make the ZAP documentation as useful as possible we know that it still needs to be improved.

The latest ZAP docs are now all available on this site but the source of those pages does vary.

Website Pages

The source for the main website pages is under https://github.com/zaproxy/zaproxy-website/tree/main/site/content

Many of the pages (including this one) have an ‘Edit on GitHub’ link in the bottom left hand corner.

Data for some of the pages is under https://github.com/zaproxy/zaproxy-website/tree/main/site/data - some of this data is maintained manually while some is maintained by automated scripts.

Desktop User Guide - Core

The source for the core part of the Desktop User Guide lives under https://github.com/zaproxy/zap-core-help/tree/main/addOns/help/src/main/javahelp/contents

Note that the online pages are only updated when there is a full ZAP release.

Desktop User Guide - Add-ons

ZAP has a plugin architecture and much of the functionality is provided by add-ons.

The source of the help for each add-on lives with each add-on, under the /src/main/javahelp/ directory.

For example:

You will see that the translations for the add-on help files also live with each add-on. These should not be updated manually as they are maintained via Crowdin. Any changes made directly to the translations in GitHub will be lost when the files are automatically updated.

API Pages

The manually maintained parts of the API pages is under https://github.com/zaproxy/zap-api-docs/tree/main/source/includes

The majority of the pages are generated - details of how to update the data used for these pages will be added soon.