Overview

Initial draft of the documentation.
This won't have all the details, but has the initial plan and we will refine while we discover things :-)

Proposed resolution

Create docs/personalization.md with terminology, high-level product requirements, model and implementation architecture.

User interface changes

None, docs.

Command icon Show commands

Start within a Git clone of the project using the version control instructions.

Or, if you do not have SSH keys set up on git.drupalcode.org:

Comments

penyaskito created an issue. See original summary.

penyaskito’s picture

penyaskito’s picture

Title: Initial documentation draft » Initial documentation draft for Personalization
Status: Active » Needs review

penyaskito’s picture

Credits for inputs.

penyaskito’s picture

Assigned: Unassigned » wim leers

I think this is good enough to iterate with.

wim leers’s picture

Assigned: wim leers » penyaskito
Status: Needs review » Needs work

Thanks so much for this! 🙏 It's super helpful 😄

Reviewed it from a high-level POV, avoided nitpicking.

Left clarification suggestions and a few questions, which are focused on increasing the clarity and hence practical usefulness of this document going forward.

The only thing I definitely want to see changed is `Component`: What we would refer to in technical terms as a `Component instance`. — that's too confusing, and in fact led to a lot of confusion when reviewing the designs.
Everything else is essentially clarifying. It'll probably take you <15 mins to address :)

wim leers’s picture

Status: Needs work » Reviewed & tested by the community

wim leers’s picture

Status: Reviewed & tested by the community » Fixed
wim leers’s picture

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.