AaltoSciComp/scicomp-docs

Merge Applications and Examples ?

tpfau opened this issue · 0 comments

tpfau commented

After Richards PR to put references/Examples higher, I'm wondering, whether Applications and examples should actually be merged in some way.
In particular, I'm wondering, whether it would make sense to at least move Programming language pages from Applications to Examples, or, as discussed with @simo-tuomisto , create example pages, that are duplicated (or have riders) for each language.
At the moment, there is e.g. an "Application" page for Python which partially contains the Examples provided in the "Examples" page.
What I would suggest is something along the lines:
In the "Applications" section split the list into "Programming Languages" and "Programs" (Or find in general better terms for the things).
Move the Examples part into the Programming Languages pages, or as sub-pages linked in there.
Build all Programming language Pages in a way that they are "the same" and only have different information if languages are indeed different (like the info on Matlab about using a specific matlab module and specifically passing in the number of workers).
Any comments on this idea?