doc/entities.md in power_stencil-0.4.21 vs doc/entities.md in power_stencil-0.4.22
- old
+ new
@@ -850,9 +850,12 @@
$ power_stencil get custom_entity/test_entity --raw
--- !ruby/object:MyCustomEntity
:name: test_entity
:parent: !entity custom_entity/foo
```
+
+:information_source: Formerly, `PowerStencil` was using a different way to represent references to other entities using a different yaml tag: `!ps_ref` (representing the reference as a map of `type` and `name`) instead of `!entity` (representing the reference as a string of the entity id, ie `<type>/<name>`). The newer version of `PowerStencil` are compatible with that old format. It will continue reading the old format as well as the new one, but if you save an entity, it will automatically be converted to the new format...
+
Here we are referencing an entity of the same type, but of course you can reference any type of entity. Using `has_one` will enforce the type of data you reference. Let's try to mess-up:
```ruby
PowerStencil DSL> e.parent = :bar
=> :bar