Bug 977045
Summary: | Guide should document chronyd, not ntpd | ||
---|---|---|---|
Product: | [Fedora] Fedora Documentation | Reporter: | Pete Travis <me> |
Component: | system-administrator's-guide | Assignee: | Stephen Wadeley <swadeley> |
Status: | CLOSED CURRENTRELEASE | QA Contact: | Fedora Docs QA <docs-qa> |
Severity: | unspecified | Docs Contact: | |
Priority: | unspecified | ||
Version: | devel | CC: | jhradile, swadeley |
Target Milestone: | --- | ||
Target Release: | --- | ||
Hardware: | Unspecified | ||
OS: | Unspecified | ||
Whiteboard: | |||
Fixed In Version: | Doc Type: | Bug Fix | |
Doc Text: | Story Points: | --- | |
Clone Of: | Environment: | ||
Last Closed: | 2015-02-14 15:54:03 UTC | Type: | Bug |
Regression: | --- | Mount Type: | --- |
Documentation: | --- | CRM: | |
Verified Versions: | Category: | --- | |
oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
Cloudforms Team: | --- | Target Upstream Version: | |
Embargoed: |
Description
Pete Travis
2013-06-22 21:46:33 UTC
Thanks, Pete. We are aware of this change and as a matter of fact, Stephen Wadeley is already working on this particular piece of documentation. First draft was sent to SME late last week, Hope to have something worth proof reading in a few days. First draft ready in repo. Feedback please. I like it, very comprehensive and well presented. Only a couple thoughts: The instructions for starting, stopping, enabling, and disabling the service are universal, and this section could refer to the "Services and Daemons" section. There could be points in favor of either a reference or a restatement, and obviously this would be your call. Later, I was a little confused by "By default, rtcsync will inform the kernel the system clock is synchronized and the kernel will update the real-time clock in 11 minute intervals." After a little reading[1], I found that 'rtcsync' is a chronyd config file directive, not a separate application, and that I was somehow confusing 'intervals' of small clock updates every 11 minutes with 11 minute 'increments'. A minor point, but it could be made more clear. [1] grep -A9 -m1 4.2.44 /usr/share/doc/chrony-1.27/chrony.txt Thank you for the feedback. Paragraph 1: A matter of style so I will leave that to the guide owner. BTW, I was taught to rather include sort descriptions than to make readers look elsewhere (subjective of course). Also, its easier to find instructions if you have short task descriptions with suitable headings. Paragraph 2: I think I took the SME too literally. I'll propose this: By default, the rtcsync directive is present in the /etc/chrony.conf file. This will inform the kernel the system clock is kept synchronized and the kernel will update the real-time clock every 11 minutes. Thank you The very helpful Miroslav Lichvar has approved my wording as in c#5. Is jhradile happy with the new headings and structure? I'd like to document chronyd in the Security Guide as well. Also, chronyd shouldn't replace ntpd in the documentation as ntpd is still being shipped, although it is no longer default. Hello Eric Point 1: I think this BZ is not the place to discuss the pros and cons of duplicating content. Point 2: I can only find a mention of ntpd in the appendix "The sysconfig Directory". I see that I have cut off some still useful commands at the end of the chapter "Configuring the Date and Time". I will add an ntpd chapter ASAP and improve the end of chapter "Configuring the Date and Time". regards Stephen I have added a chapter describing the use ntpd to configure ntp I have improved the end of the "Configuring the Date and Time" chapter. (In reply to Stephen Wadeley from comment #9) > I have added a chapter describing the use ntpd to configure ntp > > I have improved the end of the "Configuring the Date and Time" chapter. Can you provide a patch (or just the DocBook file) for this change so I can add it to the Security Guide, please? Hello Duplicating content is not a good idea. Please link to the chapters on time (ntp, chrony, and ptp) Please discuss the issue of duplication and linking in the Fedora docs meeting. Thank you You've addressed all of my concerns and provided good coverage on this topic, thank you Stephen. |