Plans for documentation
It's better to keep track of everything in one issue, instead of duplicating. If you're looking for minimalism tips you can read here, and let me know your results.
- Add formatted downloadable documents
- consider using cdrskin
- consider pointing to the debian references known issues
- use devuan.org/get-devuan to point to mirrors when this change happens
- Future guides should not at all suggest anything with libdbus dependencies if possible.
Plans for ASCII:
- Information about the default backends for each desktop and any known conflicts (task-*-desktop shows this)
- Port any current documentation to ascii
- Information on elogind, consolekit, apulse, etc
- Add information about using spaceFM in ascii since it does not hard depend on dbus there.
Plans for Jessie:
Docs we already have for Jessie wil stay frozen unless they need to be changed, apart from newer docs.
- Add screenshots for wifi installs
Plans for all releases:
- Architectures and writing images detailed pages (should not deprecate general information)
- Improve chroot installation guide
- Info about other network managers.
- Information about other lightweight desktops
- The basics of openrc
New documentation:
- Work on printing without D-Bus
- Expert install explained with screenshots. This will take some time.
- Manual disk partitioning from the installer
- Plain debootstrap chroot installs. Partly done, full install guide left to do (base on minimal live).
-
Expand on embedded installs, give explicit instructions how to use it. This is already mentioned in the sites README.txt but there is no reason not to work on a well formatted document of this kind.duplication of devuan official docs is not necessary, and may turn out to be unhelpful. - New iteration of the minimal install guide as the current process is confusing. New version will use Devuan live (using the most minimal tools for the job - fdisk, not cfdisk etc). Should be tested as compatible for all releases.
System simplification guide:
Will need to show how to do this with both sysctl and custom kernel configurations.
- Running a pure 64bit system
- Reducing sound system complexity (no OSS emulation or pulse)
- Helpful kernel patches for custom builders of kernels: patches to build to specific CPU
- blacklisting unwanted kernel modules (avoids rebuilding kernel for alsa, oss, etc): remove oss emulation
- Changing the programs that are running or run with simpler programs (sterm, mksh, dash busybox-syslogd, udhcpc, fgetty, busybox commands invokation as alternatives, simpler window managers): downside for some of this is installating extra software so it's disk space (dormant programs) vs the simplicity running programs (performance will be better in this tradeoff).
- tips on system usage, use the simplest tools possible (fdisk, dash, dpkg vs apt)
-
changed title from Later p lans for documentation to P lans for documentation
-
assigned to @dev1fanboy
-
Some of this may be too much duplication, so it may ended up getting scratched or is lower priority. If anyone wants to start work on some of the above, please let me know by opening an issue (translations are more important though imo).
So my current shortlist is:
- Using other inits on Devuan: openrc can just be installed then reboot, runit needs custom instructions (missing network information).
- Expert install (at this time work on manual disk partitioning too).
- Full debootstrap installs (this will be BIG and include some sbc/soc systems).
-
System simplification guidelow priority. - Improve chroot installation guide
- Port documentation to ASCII
-
Info on elogind, consolekit, pulse.low priority.
Edited by dev1fanboy
