Issue #18469 has been reported by Henrik Lindberg.

----------------------------------------
Bug #18469: Installation documentation does not mention need to configure 
"puppet service" and needs to specify order of actions
https://projects.puppetlabs.com/issues/18469

Author: Henrik Lindberg
Status: Unreviewed
Priority: Normal
Assignee: 
Category: documentation
Target version: 
Affected Puppet version: 
Keywords: 
Branch: 


There is a description here: 
http://docs.puppetlabs.com/guides/installation.html#start-and-enable-the-puppet-services
how to configure puppet as a service.

There are a couple of things missing from this description.

When installing "puppet" it will automatically try to start puppet as a service 
with a message/instructions that are slightly confusing, see #18468. This 
should be mentioned where the instructions show how to install "puppet" as well 
as in the section "start and enable the puppet services".

The "start and enable the puppet services" also appears out of order in the 
instructions as one needs to finish configuration (and in particular configure 
certificates before services should be started).

Suggest moving the section "start-and-enable-the-puppet-services" to right 
before "Next" as the user may want to also use an alternative web server before 
starting services.
 
The order (and to provide a better reading experience), the section that says:
<pre>Post-Install
Perform the following tasks after you finish installing Puppet.
</pre>
could numerate the steps as an introduction and make clear what must be done 
and what is optional (i.e. steps 1-n with one line of text each). Otherwise the 
reader has to read through all the text that follows before starting.



-- 
You have received this notification because you have either subscribed to it, 
or are involved in it.
To change your notification preferences, please click here: 
http://projects.puppetlabs.com/my/account

-- 
You received this message because you are subscribed to the Google Groups 
"Puppet Bugs" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/puppet-bugs?hl=en.

Reply via email to