pdk
pdk copied to clipboard
[docs] Workflow graph is likely wrong
Describe the bug There is a "PDK development workflow" info graphic in the PDK documentation, which depicts the PDK commands and suggests an order, a flow of tasks, to apply them.
The "Add your own code" and "Test & Iterate" boxes are outside of the grayish background "pdk commands" box. This is likely not fully correct, since "Test & Iterate" entails running pdk validate and pdk test unit.
To Reproduce
- Go to https://puppet.com/docs/pdk/1.x/pdk_overview.html#pdk-development-workflow
- Look at the "PDK development workflow" info graphic
Expected behavior The info graph should show the following order / workflow instead:
|
+----------------------+ |
+----------------+ | pdk new class | +---------------+ | +----------+
| pdk new module | -> | pdk new defined_type | -> | pdk validate | ---|---> | Add your |
+----------------+ | pdf new task | <- | pdk test unit | | | own code |
-> +----------------------+ +---------------+ | +----------+
+-------------+ / ^ | |
| pdk convert | / +-------------|-----------+
+-------------+ |
The "Add your own code" box should be the only one outside of the grayish background "pdk commands" box.
Additional context This is all about the content of the Puppet.com website.
This issue has been marked stale because it is open with no recent activity. The PDK Team is actively prioritizing existing bugs and new features, if this issue is still important to you please comment and we will add this to our backlog to complete.
Could maybe someone from the Puppet website team take a look at this issue?
This issue has been marked stale because it is open with no recent activity. The PDK Team is actively prioritizing existing bugs and new features, if this issue is still important to you please comment and we will add this to our backlog to complete.
Could maybe someone from the Puppet website team take a look at this issue?
This issue has been marked stale because it is open with no recent activity. The PDK Team is actively prioritizing existing bugs and new features, if this issue is still important to you please comment and we will add this to our backlog to complete.
@bittner we can take a look at this for you!
Great! Took almost 3 years, but, yeah, never lose hope. :crossed_fingers:
I hope the workflow is still correct. I'm only starting to use Puppet again, so not yet up-to-date with the latest advancements at Puppet.
Looks like this has been updated: https://www.puppet.com/docs/pdk/3.x/pdk_overview.html#pdk-development-workflow