We'll need to come up with an easy way of creating links between arbitrary document nodes. This serves several purposes: In the case of chained build steps, we should be able to indicate that several nodes refer to the same source.
And in the actual documentation, we need to link pages and sections too.
Due to nodes implementing ID properties already, one possible way to accomplish this would be to statically link to that. IDs are supposed to change if moved between parent nodes or another node is prepended before them.
So another possibility would be to create links using references to other nodes. This has the huge advantage of uniqueness, since the reference always points to the correct node. I'm not sure on how to implement this in a clean and solid way though, this will need a lot of whiteboard work 😄
We'll need to come up with an easy way of creating links between arbitrary document nodes. This serves several purposes: In the case of chained build steps, we should be able to indicate that several nodes refer to the same source.
And in the actual documentation, we need to link pages and sections too.
Due to nodes implementing ID properties already, one possible way to accomplish this would be to statically link to that. IDs are supposed to change if moved between parent nodes or another node is prepended before them.
So another possibility would be to create links using references to other nodes. This has the huge advantage of uniqueness, since the reference always points to the correct node. I'm not sure on how to implement this in a clean and solid way though, this will need a lot of whiteboard work 😄