Bug 8367 - The chapter "Customizing the User’s Session" is difficult to understand
Summary: The chapter "Customizing the User’s Session" is difficult to understand
Status: NEW
Alias: None
Product: ThinLinc
Classification: Unclassified
Component: Documentation (show other bugs)
Version: trunk
Hardware: PC Unknown
: P2 Normal
Target Milestone: MediumPrio
Assignee: Bugzilla mail exporter
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2024-06-18 11:56 CEST by William Sjöblom
Modified: 2024-06-18 13:27 CEST (History)
0 users

See Also:
Acceptance Criteria:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Description William Sjöblom cendio 2024-06-18 11:56:41 CEST 
This chapter is written from a very technical standpoint and has a wide scope. This information is definitely necessary, but should be presented in a more digestible way.

The main problem that I see is the fact that we mix minor technical details, that are not relevant for the vast majority of the audience, with good common knowledge that most ThinLinc users will need at some point.

I see benefit in splitting this chapter up into smaller pieces. For example:

- One chapter covering the profile chooser, how new profiles are created, and how the welcome message is customized (without delving into its inner workings and how it can be bypassed).

- One chapter detailing the different directories for startup scripts, referencing the chapter on the profile chooser.

- One chapter digging into the nitty-gritty details of session startup, referencing the startup script chapter.

The above is merely a proposal to better convey my point.
Note You need to log in before you can comment on or make changes to this bug.