docs: document personal data, refresh tokens and regulatory reporting - #49
Merged
Conversation
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
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.
Three gaps found while going through the code of the 3.0 line: features that ship but are documented nowhere.
Personal data
A new page,
security/personal-data.md, covering what a shop needs to answer a right of access or a right to erasure:customer:export-personal-data, with the five core sections it producescustomer:anonymize, with the table of what is erased and what is kept, and why deleting the account is not the same thingCustomerPersonalDataProviderInterface, with a worked example, so a module declares the data it holds and is called on both the export and the anonymizationmaintenance:purge, including the two customer periods that are off by default on purposeMAINTENANCE_PURGEThree command pages go with it:
customer:anonymize,customer:export-personal-dataandmaintenance:purge.The CLI index also gains
thelia:order:rounding-mode,sequence:set,import-export:cleanandhook:clean, gets the outdatedmaintenance:purgedescription fixed, and now namesthelia:cache:clearrather than Symfony'scache:clear.Refresh tokens
api/authentication.mdshowed a login response with a singletoken, while the endpoints have been returningrefresh_tokenandrefresh_token_ttlfor a while. The page now documents both refresh endpoints, the single-use rotation, the admin/front scoping, the response codes andJWT_REFRESH_TOKEN_TTL.Regulatory reporting
docs/security/cra-incident-response.mdin the main repository is complete but linked from nowhere and not published.security/security-policy.mdnow carries a section summarizing it: steward status under article 24, what triggers a notification, the ENISA channel, the 24 h / 72 h / 14 days timeline, and a link to the full process.Versioning
Every change is applied to
docs/and toversioned_docs/version-3.0/, which are otherwise identical.security/was missing entirely from the 3.0 snapshot, so the security policy page added in #47 was only visible under Next: it is now published in 3.0 as well.npm run buildpasses, with no broken link or anchor on the pages touched.