What happens when I regenerate API documentation?

[#1]

Using this example:

http://docs.apigee.com/developer-services/content/using-smartdocs-document-apis

1) Can I customize "View API affirmation"?

2) If I can customize it, can I add additional content such as images, text, tables, etc.

3) If yes, what happens to that content when I regenerate the API doc?

4) Can I regenerate 1 api? or I can only regenerate all apis?

[anilsr · Accepted solution]

@mike yang ,

Please find answers below,

1) Can I customize "View API affirmation"?

• Yes, You can, You need to Edit Smartdocs template. See the settings page of smartdocs model to edit the template.

2) If I can customize it, can I add additional content such as images, text, tables, etc.

• You need to leverage Drupal Views & Blocks along with SmartDocs content type fields to add this information.
• Yes, It's possible
• Need little bit of Drupal Expertise.

3) If yes, what happens to that content when I regenerate the API doc?

• Content is managed in Drupal CMS. When you regenerate docs, It won't be affected. It will create a new revision. Your content managed in CMS statys as it is. If you would like to , You can edit / update same.

4) Can I regenerate 1 api? or I can only regenerate all apis?

• You can do that, You can re-generate single API.

[#3]

@Anil Sagar

On Point #3, it creates a new revision/skeleton with the most up to date API info, but all the other content that was created manually around it only exists in the current revision. That content will need to be copy and pasted in the newest revision. Correct?