Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Proposal for a table overview in Shell.nix tutorial #681

Draft
wants to merge 3 commits into
base: master
Choose a base branch
from

Conversation

VuiMuich
Copy link

As mentioned on reddit IMO it would be nice to have a condened overview as a table at the beginning.

(Draft as this is just a stylistic proposal as discussion basis and eventually should porbably be expanded on all tutorial articles.)

@zmitchell
Copy link
Contributor

I'm generally in support of this, but the exact format could use some bikeshedding since we'd want it to look nice regardless of the length of the content in each part of the table.

@VuiMuich
Copy link
Author

As far as I can tell the mark down renderer is responsible for line wrapping the individual cells.
Tbh I have no idea if or how it would be possible to enforce a static width of the columns, is this possible in the custom css?
I tested with glow to render in the terminal and it automatically to a relative compact table with three lines and with litemdview which offers a very nice responsive result.

@VuiMuich
Copy link
Author

Also was considering adding the tooltip link to the time itself and changing the clock for an icon more representing "intercativity":

📖 🕹 What will you learn? What will you need?
10 min 30 min How to create and configure reproducible shell environments A basic understanding of the Nix language

@fricklerhandwerk
Copy link
Collaborator

All in all this could be structured data that one would find a suitable representation for. But we have to make a trade-off with maintainability ease of contributor onboarding, and in that regard I subscribe to a low-tech paradigm. Therefore I would rather keep it as it is, as any new moving part needs explanation of how it works and how to deal with it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants