How Helix Works, initial version #51
Conversation
| supplied in the GitHub source repository. | ||
|
|
||
| Updates to these components are atomic, and the Helix Strains let users define staged variants of their content, to have | ||
| full control on the publishing process and allow for intermediate reviews before publishing content. |
There was a problem hiding this comment.
I'm not sure we should advertise this 'publishing process' at this point because I don't think we've converged on a recommended practice for it yet. If we have and I just don't know it, great, but then we should document it 😄
There was a problem hiding this comment.
Makes sense, removing this!
…t as per Fil's comments
|
Thank you very much @filmaj for your feedback! I have redone the diagram and updated the text as per your comments. GraphViz diagram...I did the diagram with GraphViz and I like the text-based process and the result is informative IMHO and not too bad visually. We'll probably redo of of those diagrams "by hand" eventually to make them look nicer, but in this development phase I think using text-based diagrams gives us a much better chance for them to stay in sync with reality, even if they don't look as good visually as we'll ultimately want. |
|
Thank you @filmaj - I don't seem to have karma to merge, not sure if I need to ping someone to do that or how that works. |
|
I can merge but I don't want to do it without someone from the core project team approving. |
|
Excellent, thanks @bdelacretaz. Merged. |
|
related: adobe/helix-cli#711 |
Please review the diagram and explanations, and also whether we're ready to expose that information on the public https://www.project-helix.io/ website.
I used https://monodraw.helftone.com/ to create the diagram but its ASCII output is not easy to modify if you don't have the source
.monopicfile so it's not really better than other diagramming tools which all have their own format.Maybe we should use GraphViz (as an extension in I/O runtime) to generate diagrams on the fly from Markdown file sections.