Documentation for Access Control and Page Security is invalid

Open
#27 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
35/100
Issue type
Documentation
Clarity
Needs clarification
Activity status
Stale
Domain
documentation

Research direction

Start with the linked Access Control page, especially the “Permission checking is at class level” section, and review the existing content as a whole. Done means the page has been rewritten into a useful developer guide that properly explains SilverStripe’s Access Control model.

Written by the indexing model from the issue text.

Description

affects/v4 complexity/low impact/low type/docs

Affected Version

Documentation site

Description

On the documentation site, the Access Control page doesn't contain a lot of useful information, and reads more like a stream of consciousness while someone was reading the code, rather than a useful developer guide. The whole page has this sort of content, but the 'Permission checking is at class level' section is probably the worst offender.

The page should ideally be re-written to properly cover the Access Control model that SilverStripe implements.

I'll try to do this in a PR, but no guarantees - adding this issue in case I don't get a chance to re-write it.

Dominant language
No language data
Stars
7
Forks
74
Avg merge
1d 14m
Merged PRs (30d)
6

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from silverstripe/developer-docs

All issues in silverstripe/developer-docs

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.