add selkies platform documentation, add mermaid dep for drawing flow charts - #43
Conversation
| **Browsers and web:** Brave, Chrome, Chromium, Firefox, Helium, Librewolf, Msedge, Mullvad Browser, Opera, Ungoogled Chromium, Vivaldi, Zen, Webstation | ||
|
|
||
| **Communication:** Altus, Ferdium, Pidgin, Signal, Telegram, Thunderbird, Webcord, Weixin | ||
|
|
||
| **Development:** Github Desktop, Gitqlient, Intellij Idea, Mysql Workbench, Pycharm, Sqlitebrowser, Vscode, Vscodium, Yaak | ||
|
|
||
| **Creative and media:** Ardour, Audacity, Blender, Darktable, Digikam, Gimp, Handbrake, Inkscape, Kdenlive, Krita, Lollypop, Rawtherapee, Shotcut, Spotube, Vlc | ||
|
|
||
| **Office and productivity:** Calibre, Calligra, Joplin, Libreoffice, Obsidian, Onlyoffice, Wps Office, Zotero | ||
|
|
||
| **3D printing and engineering:** Bambustudio, Cura, Freecad, Kicad, Orcaslicer | ||
|
|
||
| **Gaming and emulation:** Azahar, Blade of Agony, Dolphin, Dosbox Staging, Duckstation, Eden, Flycast, Gzdoom, Mame, Melonds, Modrinth, Pcsx2, Ppsspp, Retroarch, Rpcs3, shadPS4, Steam, Xemu, Dogwalk | ||
|
|
||
| **Utilities and other:** Boinc, Doublecommander, Filezilla, Keepassxc, Kali Linux, Mediaelch, Qdirstat, Remmina, Rustdesk, Wireshark, WineGUI |
There was a problem hiding this comment.
This reads like a complete list, but it's static.
We can make this dynamic if desired, with downstream modifications.
There was a problem hiding this comment.
Whats the plan, run a step on images that have the selkies blurb enabled to template in ? Just trying to think of solutions and the blurb is a good tag, it should be on all selkies images.
There was a problem hiding this comment.
Either make the list less complete, or have the generate-images-by-category.py script generate a file we can import into this file, based on metadata. Either by a selkies category, or injecting some other value to frontmatter with jenkins.
There was a problem hiding this comment.
Ok I simplified it to just go over categories for now. I'll ponder a better centralized list as now sealskin is manually maintained for the app list.
Roxedus
left a comment
There was a problem hiding this comment.
I have not verified the content of the pages, but nav, links and diagrams works locally.
|
Yeah that is fine, this will not be static docs, it will evolve over time. This is a good starting point though I have read through it a bunch of times. |
This adds docs for the full selkies platform.
Includes sections for users, developers, and explainers for all the components that make up the baseimages.
I am tired of fielding the same questions on repeat and need stuff like the quickstart and basic troubleshooting to link people to. I expanded into development docs as well to better explain how and why to make 3rd party images.
Mermaid is needed for the flow charts in some docs, I do not expect a team member to read every line of this given the size, but a glance over would be appreciated.