Jira (PDB-5500) Bad class title examples in PQL tutorial documentation

12 views
Skip to first unread message

Stel Abrego (Jira)

unread,
Jun 8, 2022, 5:42:03 PM6/8/22
to puppe...@googlegroups.com
Stel Abrego created an issue
 
PuppetDB / Improvement PDB-5500
Bad class title examples in PQL tutorial documentation
Issue Type: Improvement Improvement
Assignee: Unassigned
Created: 2022/06/08 2:41 PM
Priority: Normal Normal
Reporter: Stel Abrego

PQL tutorial documentation in documentation/api/query/tutorial-pql.markdown contains PQL examples for querying for the Apache class that don't work with the official Apache module in the Puppet Forge. There are several examples where the class title is "apache" when it should be "Apache". The first letter must be capitalized in queries for class names.

Add Comment Add Comment
 
This message was sent by Atlassian Jira (v8.20.2#820002-sha1:829506d)
Atlassian logo

Stel Abrego (Jira)

unread,
Jun 8, 2022, 5:58:03 PM6/8/22
to puppe...@googlegroups.com
Stel Abrego updated an issue
Change By: Stel Abrego
PuppetDB's [ PQL tutorial documentation |https://puppet.com/docs/puppetdb/7/api/query/tutorial-pql.html] in documentation/api/query/tutorial-pql.markdown contains PQL examples for querying for the Apache class that don't work with the official Apache module in the Puppet Forge. There are several examples where the class title is "apache" when it should be "Apache". The first letter must be capitalized in queries for class names.

Side note: The Puppet language [requires|https://puppet.com/docs/puppet/7/lang_reserved.html#classes-and-defined-resource-type-names] that names of classes start with a lowercase letter. Somewhere along the way to PuppetDB's representation (maybe in Puppet agent?) the first letter of the class name/title is made uppercase. This may be a source of confusion for our users.

Stel Abrego (Jira)

unread,
Jun 8, 2022, 5:59:03 PM6/8/22
to puppe...@googlegroups.com
Stel Abrego updated an issue
PuppetDB's [PQL tutorial documentation|https://puppet.com/docs/puppetdb/7/api/query/tutorial-pql.html] in documentation/api/query/tutorial-pql.markdown contains PQL examples for querying for the Apache class that don't work with the official Apache module in the Puppet Forge. There are several examples where the class title is "apache" when it should be "Apache". The first letter must be capitalized in queries for class names /titles .


Side note: The Puppet language [requires|https://puppet.com/docs/puppet/7/lang_reserved.html#classes-and-defined-resource-type-names] that names of classes start with a lowercase letter. Somewhere along the way to PuppetDB's representation (maybe in Puppet agent?) the first letter of the class name/title is made uppercase. This may be a source of confusion for our users.

Stel Abrego (Jira)

unread,
Jul 18, 2022, 3:05:03 PM7/18/22
to puppe...@googlegroups.com
Stel Abrego updated an issue
Change By: Stel Abrego
Fix Version/s: PDB 6.22.0
Reply all
Reply to author
Forward
0 new messages