Jira (PDB-2326) PQL: For docs, split out model from endpoints into a single doc

3 views
Skip to first unread message

Kenneth Barber (JIRA)

unread,
Jan 19, 2016, 9:03:03 AM1/19/16
to puppe...@googlegroups.com
Kenneth Barber created an issue
 
PuppetDB / Task PDB-2326
PQL: For docs, split out model from endpoints into a single doc
Issue Type: Task Task
Assignee: Unassigned
Created: 2016/01/19 6:02 AM
Fix Versions: PDB 4.0.0
Priority: Normal Normal
Reporter: Kenneth Barber

Right now all the model information about entities, such as fields and such are kept in the various endpoint documents. This isn't as accessible as I'd like it to be for the purposes of PQL. We should take the model documentation out of the endpoints, and instead extend entities.markdown/html to include all model information for all entities. Endpoint docs can then reference those pages.

Other ideas

  • maybe we squash the endpoints into 1 doc perhaps, now the model information is on its own?
  • the model is going to be fairly repetitive, we should consider using the Liquid templating that is provided on the docs website, to format information on the model from data. The data itself can be stored in the front-matter (the little bit of YAML at the top of each file) of the markdown for now, until we can extract it from the engine automatically perhaps.
  • in the future obviously, it would be lovely to generate this model documentation automatically from the query engines information about the model.
Add Comment Add Comment
 
This message was sent by Atlassian JIRA (v6.4.12#64027-sha1:e3691cc)
Atlassian logo

Ryan Senior (JIRA)

unread,
Jan 27, 2016, 11:18:06 AM1/27/16
to puppe...@googlegroups.com
Ryan Senior updated an issue
Change By: Ryan Senior
Sprint: PuppetDB 2016- 02 03 - 10 09

Susan McNerney (JIRA)

unread,
Feb 1, 2016, 12:42:07 PM2/1/16
to puppe...@googlegroups.com

Kenneth Barber (JIRA)

unread,
Mar 8, 2016, 10:09:03 AM3/8/16
to puppe...@googlegroups.com
Kenneth Barber updated an issue
Change By: Kenneth Barber
Sprint: PuppetDB 2016- 03 04 - 23 06

Kenneth Barber (JIRA)

unread,
Mar 22, 2016, 3:11:04 PM3/22/16
to puppe...@googlegroups.com
Kenneth Barber updated an issue
Change By: Kenneth Barber
Story Points: 2 5
This message was sent by Atlassian JIRA (v6.4.13#64028-sha1:b7939e9)
Atlassian logo

Kenneth Barber (JIRA)

unread,
Mar 22, 2016, 3:14:04 PM3/22/16
to puppe...@googlegroups.com

Susan McNerney (JIRA)

unread,
Apr 6, 2016, 12:17:04 PM4/6/16
to puppe...@googlegroups.com
Susan McNerney updated an issue
Change By: Susan McNerney
Sprint: PuppetDB 2016- 05- 04 -20

Ryan Senior (JIRA)

unread,
Apr 6, 2016, 12:19:09 PM4/6/16
to puppe...@googlegroups.com
Ryan Senior updated an issue
Change By: Ryan Senior
Sprint: PuppetDB 2016-04-20 Hopper

Ryan Senior (JIRA)

unread,
May 18, 2016, 3:37:04 PM5/18/16
to puppe...@googlegroups.com
Ryan Senior updated an issue
Change By: Ryan Senior
Fix Version/s: PDB 4.1.0
Fix Version/s: PDB 4.2.0

Ryan Senior (JIRA)

unread,
May 23, 2016, 5:47:03 PM5/23/16
to puppe...@googlegroups.com

Ryan Senior (JIRA)

unread,
Aug 4, 2016, 4:55:04 PM8/4/16
to puppe...@googlegroups.com

Austin Blatt (Jira)

unread,
May 29, 2020, 12:34:03 PM5/29/20
to puppe...@googlegroups.com
Austin Blatt updated an issue
Change By: Austin Blatt
Labels: docs-pdb query-engine-improvements
This message was sent by Atlassian Jira (v8.5.2#805002-sha1:a66f935)
Atlassian logo
Reply all
Reply to author
Forward
0 new messages