Jira (BOLT-1422) Update command reference docs
Title: Message Title Chris Cowell updated an issue Puppet Task Runner / BOLT-1422 Update command reference docs Change By: Chris Cowell Labels: DOCS docs docs_reviewed Add Comment This message was sent by Atlassian JIRA (v7.7.1#77002-sha1:e75ca93) -- You received this message because you are subscribed to the Google Groups "Puppet Bugs" group. To unsubscribe from this group and stop receiving emails from it, send an email to puppet-bugs+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/puppet-bugs/JIRA.313638.1561140371000.57119.1565822580304%40Atlassian.JIRA.
Jira (BOLT-1422) Update command reference docs
Title: Message Title Tom Beech updated an issue Puppet Task Runner / BOLT-1422 Update command reference docs Change By: Tom Beech Fix Version/s: BOLT Next Add Comment This message was sent by Atlassian JIRA (v7.7.1#77002-sha1:e75ca93) -- You received this message because you are subscribed to the Google Groups "Puppet Bugs" group. To unsubscribe from this group and stop receiving emails from it, send an email to puppet-bugs+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/puppet-bugs/JIRA.313638.1561140371000.54864.1565740380236%40Atlassian.JIRA.
Jira (BOLT-1422) Update command reference docs
Title: Message Title Cas Donoghue updated an issue Puppet Task Runner / BOLT-1422 Update command reference docs Change By: Cas Donoghue Release Notes: Not Needed Add Comment This message was sent by Atlassian JIRA (v7.7.1#77002-sha1:e75ca93) -- You received this message because you are subscribed to the Google Groups "Puppet Bugs" group. To unsubscribe from this group and stop receiving emails from it, send an email to puppet-bugs+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/puppet-bugs/JIRA.313638.1561140371000.47058.1565200440202%40Atlassian.JIRA.
Jira (BOLT-1422) Update command reference docs
Title: Message Title Tom Beech assigned an issue to Tom Beech Puppet Task Runner / BOLT-1422 Update command reference docs Change By: Tom Beech Assignee: Tom Beech Add Comment This message was sent by Atlassian JIRA (v7.7.1#77002-sha1:e75ca93) -- You received this message because you are subscribed to the Google Groups "Puppet Bugs" group. To unsubscribe from this group and stop receiving emails from it, send an email to puppet-bugs+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/puppet-bugs/JIRA.313638.1561140371000.43456.1565029080401%40Atlassian.JIRA.
Jira (BOLT-1422) Update command reference docs
Title: Message Title Tom Beech updated an issue Puppet Task Runner / BOLT-1422 Update command reference docs Change By: Tom Beech Sprint: Bolt Ready for Grooming Kanban Add Comment This message was sent by Atlassian JIRA (v7.7.1#77002-sha1:e75ca93) -- You received this message because you are subscribed to the Google Groups "Puppet Bugs" group. To unsubscribe from this group and stop receiving emails from it, send an email to puppet-bugs+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/puppet-bugs/JIRA.313638.1561140371000.43455.1565029080349%40Atlassian.JIRA.
Jira (BOLT-1422) Update command reference docs
Title: Message Title Lucy Wyman updated an issue Puppet Task Runner / BOLT-1422 Update command reference docs Change By: Lucy Wyman Labels: DOCS docs Add Comment This message was sent by Atlassian JIRA (v7.7.1#77002-sha1:e75ca93) -- You received this message because you are subscribed to the Google Groups "Puppet Bugs" group. To unsubscribe from this group and stop receiving emails from it, send an email to puppet-bugs+unsubscr...@googlegroups.com. To post to this group, send email to puppet-bugs@googlegroups.com. Visit this group at https://groups.google.com/group/puppet-bugs. To view this discussion on the web visit https://groups.google.com/d/msgid/puppet-bugs/JIRA.313638.1561140371000.59517.1561477080272%40Atlassian.JIRA. For more options, visit https://groups.google.com/d/optout.
Jira (BOLT-1422) Update command reference docs
Title: Message Title Melissa Amos commented on BOLT-1422 Re: Update command reference docs I set up a prototype for `command run`. Partial screenshot shown: (I'm not leaving this live in the preview docs because it will get pushed to production automatically when we release.) This layout seems like a big improvement over the current model. However, the timing to implement this change is tricky. We're currently reconsidering how we handle Bolt docs, so I'm not sure if makes sense to make this formatting change in the GitHub pre-docs, our docs source, or both. If it's possible to hold off on making this change until we have a clear path forward for managing Bolt docs source, that would probably save time in the long run. Michelle Fredette This mocked-up topic is command_run.dita in the Bolt dev branch. If we decide to continue building Bolt docs from DITA source, from a technical standpoint, it makes sense to break up the command reference this way. The existing setup has the entire command reference in a single topic, and it's too much for easyDITA, causing the topic to bounce around in editing mode, etc. I envisioned single-sourcing the options in the tables. Potentially, you could duplicate the existing command reference topic and use it as a new conref topic, wrap the contents of each table cell in elements and assign IDs, and then conref the s into command topics as needed. If you need an example: the PE port requirements tables are set up similarly. This sounds like some work, but it will be much easier than maintaining separate options references for each command. Add Comment This message was sent by Atlassian JIRA (v7.7.1#77002-sha1:e75ca93)
Jira (BOLT-1422) Update command reference docs
Title: Message Title Melissa Amos updated an issue Puppet Task Runner / BOLT-1422 Update command reference docs Change By: Melissa Amos Attachment: Screen Shot 2019-06-21 at 11.19.30 AM.png Add Comment This message was sent by Atlassian JIRA (v7.7.1#77002-sha1:e75ca93) -- You received this message because you are subscribed to the Google Groups "Puppet Bugs" group. To unsubscribe from this group and stop receiving emails from it, send an email to puppet-bugs+unsubscr...@googlegroups.com. To post to this group, send email to puppet-bugs@googlegroups.com. Visit this group at https://groups.google.com/group/puppet-bugs. To view this discussion on the web visit https://groups.google.com/d/msgid/puppet-bugs/JIRA.313638.1561140371000.56927.1561141200358%40Atlassian.JIRA. For more options, visit https://groups.google.com/d/optout.
Jira (BOLT-1422) Update command reference docs
Title: Message Title Tom Beech updated an issue Puppet Task Runner / BOLT-1422 Update command reference docs Change By: Tom Beech Labels: docs Summary: (docs) Update command reference docs Add Comment This message was sent by Atlassian JIRA (v7.7.1#77002-sha1:e75ca93) -- You received this message because you are subscribed to the Google Groups "Puppet Bugs" group. To unsubscribe from this group and stop receiving emails from it, send an email to puppet-bugs+unsubscr...@googlegroups.com. To post to this group, send email to puppet-bugs@googlegroups.com. Visit this group at https://groups.google.com/group/puppet-bugs. To view this discussion on the web visit https://groups.google.com/d/msgid/puppet-bugs/JIRA.313638.1561140371000.56902.1561140480086%40Atlassian.JIRA. For more options, visit https://groups.google.com/d/optout.
Jira (BOLT-1422) Update command reference docs
Title: Message Title Tom Beech created an issue Puppet Task Runner / BOLT-1422 Update command reference docs Issue Type: Improvement Assignee: Unassigned Created: 2019/06/21 11:06 AM Priority: Normal Reporter: Tom Beech The command reference documentation should show a list of options available for each command. Currently, the options are separate from the commands and do not show the relationship between the two, making it unclear which options work with which commands. https://puppet.com/docs/bolt/latest/bolt_command_reference.html Add Comment This message was sent by Atlassian JIRA (v7.7.1#77002-sha1:e75ca93)
