Open lauracowen opened 1 year ago
Sounds like we need more of the why besides the what. =)
I reviewed this guide for ID, but I agree with Laura. It could do with more context throughout- w/in each heading it should be more clear why/when you might take that particular tac, whether by giving a concise example or clearly stating the value/benefit before getting into the actual config
please add me as a reviewer on any PR to address these comments and I can work with the writer to get it in shape
I've provided detailed comments as I went through but I think the guide needs revising a bit to provide more explanation and to structure the sections in more of a pyramid way (start with a summary to orientate the reader, then go into detail).
DEFINING A PROPERTY WITH EXPRESSIONS
RETRIEVING PROPERTY AS A LIST
I think maybe work with @dmuelle or other ID person (talk to David to see if he knows someone who can help) to structure the sections and provide more explanation rather than simply providing a series of steps.