Open abelsiqueira opened 5 months ago
Is it normal that I have a "Unable to render rich display" error?
Unfortunately, it is not rendering - and it's incomplete - so I am thinking of using another tool.
On Thu, Jan 18, 2024, 10:47 Lauren Clisby @.***> wrote:
Is it normal that I have a "Unable to render rich display" error?
— Reply to this email directly, view it on GitHub https://github.com/TulipaEnergy/TulipaEnergyModel.jl/issues/415#issuecomment-1898136886, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAIE5UCTWP56UK7XOAWAIQ3YPDVRFAVCNFSM6AAAAABB6R44POVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMYTQOJYGEZTMOBYGY . You are receiving this because you authored the thread.Message ID: @.***>
Updated with app.diagrams.net / draw.io version.
Works now! 👍
@abelsiqueira @suvayu Maybe this is a good candidate for a wiki? 🙃
Have we decided what use we'll be moving to the wiki? We have 6 places for prose right now:
So it might be useful to redefine some things to give use to the wiki. Also, it is a good time to bring up https://diataxis.fr, since it relates to documentation and purpose.
Diataxis was a great read! I agree we're spreading out a bit, but this is something that doesn't seem to really belong in an issue... Maybe it can go into the docs? Right now it's pretty dev-related, but eventually might be useful to the user.
@abelsiqueira Is there a way we can have this generate with code? That way we can put it in the docs without screenshotting it and keep it updated in the future (maybe add it to our PR checklist?)
Is there a way we can have this generate with code?
Thinking like an engineer @clizbe ;-)
We could explore using Mermaid.js
. It's supported by GitHub. You can experiment @ https://mermaid.live/
Great! Let's use that. It'll probably take some work for the first version but updating after that shouldn't be bad. Or maybe we can shop around and see if there's a similar package that's better...
I've updated the diagram with the mermaid version. It is still a mix of current and desired structure. In the following weeks I hope to converge on something more concrete.
Create a diagram to help describe all steps and inputs of the workflow.
Related Issues:
414
Last update: 27/06/2024
I've split the diagram into two parts. One for the pipeline and one for the DBs. They are both still WIP, and the DBs are mostly just showing the keys.
High level overview of compact usage
The DB diagram is not automatically generated, here is a snapshot, the code is below.