Section 4.2 could use a little TLC?
| Affects | Status | Importance | Assigned to | Milestone | |
|---|---|---|---|---|---|
| Upstart Cookbook |
New
|
Undecided
|
Unassigned | ||
Bug Description
Please bear in mind this is all coming from the perspective of a new user attempting to learn Upstart for the first time. However, the cookbook was fairly adamant in its call for feedback, so here you go. :)
Section 4.2, 'Job Configuration File', contains the following:
> Job configuration files can exist in two types of location, depending on whether they are a System Job or a User Job.
As a reader, this leaves me with the impression I will probably be reading about System Jobs and User Jobs next. Which is true- these are the next two sections. However, the User Jobs section informs me that User Jobs are deprecated and no longer recommended, and the recommended replacement is Session Jobs, so I wonder why User Jobs are even where they
After Session Jobs, there is a fourth section, called "Odd Jobs". It turns out there is not such a thing as an 'odd job'; it is just a collection of information that can apply to any job.
It feels like this section could be pared down to System Jobs and Session Jobs, with the information in Odd Jobs moving somewhere else.
