Bug 1819150

Summary: [RFE] Incorporate apipie-dsl to document template macros, provided as in-app documentation
Product: Red Hat Satellite Reporter: Marek Hulan <mhulan>
Component: Provisioning TemplatesAssignee: Oleh Fedorenko <ofedoren>
Status: CLOSED ERRATA QA Contact: Roman Plevka <rplevka>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 6.4CC: egolov, mawerner, mhulan, mzalewsk
Target Milestone: 6.9.0Keywords: FutureFeature, Triaged
Target Release: Unused   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: foreman-2.2.0, foreman-installer-2.3.0-0 Doc Type: Enhancement
Doc Text:
Template macro documentation has been added inside Red Hat Satellite to help you create your own customer reporting templates.
Story Points: ---
Clone Of: Environment:
Last Closed: 2021-04-21 13:12:29 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On: 1865862, 1865872, 1865886, 1865928, 1866029, 1903101    
Bug Blocks:    

Description Marek Hulan 2020-03-31 10:26:26 UTC
The documentation should be available as part of installed Foreman (similar to /apidoc).

Comment 1 Marek Hulan 2020-03-31 10:26:39 UTC
Created from redmine issue https://projects.theforeman.org/issues/29434

Comment 2 Marek Hulan 2020-03-31 10:26:44 UTC
Upstream bug assigned to ofedoren

Comment 4 Marek Hulan 2020-03-31 10:50:30 UTC
*** Bug 1818876 has been marked as a duplicate of this bug. ***

Comment 5 Bryan Kearney 2020-04-27 20:54:59 UTC
Moving this bug to POST for triage into Satellite 6 since the upstream issue https://projects.theforeman.org/issues/29434 has been resolved.

Comment 9 Marek Hulan 2020-09-21 15:56:32 UTC
Currently, the `foreman-rake apipie_dsl:cache` needs to be run before accessing the documentation.

Comment 10 Evgeni Golov 2020-10-27 10:55:47 UTC
The installer changes aren't done yet → assigned.

Comment 11 Bryan Kearney 2020-10-27 12:05:17 UTC
Moving this bug to POST for triage into Satellite since the upstream issue https://projects.theforeman.org/issues/29434 has been resolved.

Comment 12 Mirek Długosz 2020-11-16 16:13:16 UTC
Marek,

If I recall correctly, rake task was already shipped in Satellite 6.8, and we also provided generated docs in KB article. So the only visible change in 6.9 is that now we also have link in Administer -> About.
And I guess rake task is run during installation, so this link leads to existing page.

Is that correct? Or is there more to check before I flip that to VERIFIED?

Comment 13 Marek Hulan 2020-11-18 10:36:06 UTC
You're right. The only visible change is the link you mention and the fact, the documention should be generated automatically, no need to run the rake task manually to make the link working.

Comment 16 errata-xmlrpc 2021-04-21 13:12:29 UTC
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory (Moderate: Satellite 6.9 Release), and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHSA-2021:1313