Jira (PUP-9425) Docs Process Improvements

1 view
Skip to first unread message

Kris Bosland (JIRA)

unread,
Jan 10, 2019, 5:06:03 PM1/10/19
to puppe...@googlegroups.com
Kris Bosland updated an issue
 
Puppet / Epic PUP-9425
Docs Process Improvements
Change By: Kris Bosland
Summary: Docs Process improvements Improvements
Add Comment Add Comment
 
This message was sent by Atlassian JIRA (v7.7.1#77002-sha1:e75ca93)
Atlassian logo

Kris Bosland (JIRA)

unread,
Jan 10, 2019, 5:06:03 PM1/10/19
to puppe...@googlegroups.com
Kris Bosland updated an issue
Change By: Kris Bosland
Epic Name: Docs Process improvements Improvements

Kris Bosland (JIRA)

unread,
Jan 10, 2019, 5:22:03 PM1/10/19
to puppe...@googlegroups.com
Kris Bosland updated an issue
Change By: Kris Bosland
Acceptance Criteria: Replace outdated docs process with more modern tools.

Currently the best tool for managing data related to docs is puppet strings

 

Kris Bosland (JIRA)

unread,
Jan 10, 2019, 5:39:03 PM1/10/19
to puppe...@googlegroups.com
Kris Bosland updated an issue
Change By: Kris Bosland
Acceptance Criteria:
Replace outdated docs process with more modern tools.

Currently the best tool for managing data related to docs is puppet strings
Facter doc generation is a separate process.  

Kris Bosland (JIRA)

unread,
Jan 18, 2019, 2:34:02 PM1/18/19
to puppe...@googlegroups.com
Kris Bosland updated an issue
Change By: Kris Bosland
Acceptance Criteria:
Replace outdated docs process with more modern tools.

Currently the best tool for managing data related to docs is puppet strings

Facter doc generation is a separate process.  


Some known issues to solve:
# required_features is not included in string output (now in PUP-9451)
# Some properties are copied from old output to new (strings) output - are they still needed?

Kris Bosland (JIRA)

unread,
Feb 4, 2019, 3:15:03 PM2/4/19
to puppe...@googlegroups.com
Kris Bosland updated an issue
Change By: Kris Bosland
Acceptance Criteria: Goal: Replace outdated docs process with more modern tools.

 Mitigate or Eliminate extra docs team effort.

Remove unmaintainable code.

Currently the best tool for managing data related to docs is puppet strings

Facter doc generation is a separate process.

Some known issues to solve:
# required_features is not included in string output (now in PUP-9451)
# Some properties are copied from old output to new (strings) output - are they still needed?

## In some cases, these are edits for clarity, which may not translate well into tooling.

Kris Bosland (JIRA)

unread,
Feb 4, 2019, 4:12:03 PM2/4/19
to puppe...@googlegroups.com
Kris Bosland updated an issue
Change By: Kris Bosland
Acceptance Criteria:
Goal: Replace outdated docs process with more modern tools.

Mitigate or Eliminate extra docs team effort.

Remove unmaintainable code.

Currently the best tool for managing data related to docs is puppet strings

Facter doc generation is a separate process.

Some known issues to solve:
# required_features is not included in string output (now in PUP-9451)
# Some properties are copied from old output to new (strings) output - are they still needed?
## In some cases, these are edits for clarity, which may not translate well into tooling.


Questions for Jean:

1. Do you have any tool flow issues, e.g. confusing or difficult setup, inconvenient requirements, bad caching?

Josh Cooper (JIRA)

unread,
Feb 5, 2019, 5:01:05 PM2/5/19
to puppe...@googlegroups.com
Josh Cooper updated an issue
Change By: Josh Cooper
Team/s: Coremunity

Kris Bosland (JIRA)

unread,
Feb 8, 2019, 2:23:03 PM2/8/19
to puppe...@googlegroups.com
Kris Bosland updated an issue
Change By: Kris Bosland
Acceptance Criteria:
Goal: Replace outdated docs process with more modern tools.

Mitigate or Eliminate extra docs team effort.

Remove unmaintainable code.

Currently the best tool for managing data related to docs is puppet strings

Facter doc generation is a separate process.

Some known issues to solve:
# required_features is not included in string output (now in PUP-9451)
# supported features? missing
# Some properties are copied from old output to new (strings) output - are they still needed?

## In some cases, these are edits for clarity, which may not translate well into tooling.
## (actually, no known formatting issues - heredocs should have markdown syntax for formatting)
## 'provider' attribute missing - is this just no longer in Puppet 6

Questions for Jean:

1. Do you have any tool flow issues, e.g. confusing or difficult setup, inconvenient requirements, bad caching?

Josh Cooper (Jira)

unread,
Mar 13, 2020, 8:05:03 PM3/13/20
to puppe...@googlegroups.com
Josh Cooper updated an issue
Change By: Josh Cooper
Team/s: Coremunity Puppet Developer Experience
This message was sent by Atlassian Jira (v8.5.2#805002-sha1:a66f935)
Atlassian logo
Reply all
Reply to author
Forward
0 new messages