Update docs/best-practices/flat-file-alternative.md,...

Update docs/best-practices/flat-file-alternative.md, docs/best-practices/cai-vs-cdi.md, docs/best-practices.md, README.md, docs/secure-agent.md

README.md

+# Table of Contents
+
+- [Other Pages](#other-pages)
+- [Informatica Integration Cloud Services](#informatica-integration-cloud-services)
+- [Benefits](#benefits)
+- [Documentation](#documentation)
+- [Adding New Content](#adding-new-content)
+
+# Other Pages
+* [On-Boarding to IICS](./docs/on-boarding-to-iics.md)
+* [Logging in](./docs/logging-in.md)
+* [Training](./docs/training/training.md)
+* [Best Practices And Recommendations](./docs/best-practices.md)
+* [Tutorials](./docs/tutorials.md)
+* [Secure Agents](./docs/secure-agent.md)
+* [Shared Orgs and Sub Orgs](./docs/shared-org-vs-sub-org.md)
+* [Get Help](./get-help.md)
+
 # Informatica Integration Cloud Services
 Informatica Intelligent Cloud Services (IICS) is a platform that enables data integration between systems and 
 applications, including on-premise-to-cloud, cloud-to-cloud, and cloud-to-on-premise.  IICS belongs to a class of 
@@ -38,12 +56,3 @@ IICS is part of the infrastructure and services being delivered by the [Interope
 
 ## Adding New Content
 Use [template.md](./template.md) to create new content.
-
-## Contents
-* [On-Boarding to IICS](./docs/on-boarding-to-iics.md)
-* [Logging in](./docs/logging-in.md)
-* [Training](./docs/training/training.md)
-* [Best Practices And Recommendations](./docs/best-practices.md)
-* [Tutorials](./docs/tutorials.md)
-* [Shared Orgs and Sub Orgs](./docs/shared-org-vs-sub-org.md)
-* [Get Help](./get-help.md)

docs/best-practices.md

@@ -5,6 +5,5 @@ Here are some recommended best practices for designing and working with integrat
 * [Working In a Shared Environment](best-practices/shared-environment.md)
 * [Naming Conventions](best-practices/naming.md)
 * [AWS S3 as a Flat file alternative](best-practices/flat-file-alternative.md)
-* [Secure Agents](best-practices/secure-agent.md)
-* [Cloud Data Integration (CDI) and Cloud Application Integration (CAI)](best-practices/cai-vs-cdi.md)
+* [Cloud Data Integration (CDI) vs. Cloud Application Integration (CAI)](best-practices/cai-vs-cdi.md)
 * [Migrating Assets between Organizations](best-practices/asset-migration.md)

docs/best-practices/cai-vs-cdi.md

-# Cloud Data Integration (CDI) and Cloud Application Integration (CAI)
+# Cloud Data Integration (CDI) vs. Cloud Application Integration (CAI)
 
 ![CDI-CAI](../images/CDI-CAI-venn-diagram.svg)
 
 The diagram source can be found [here](https://app.lucidchart.com/documents/edit/5ab81deb-0dd1-4ca4-9f8b-f1fa2706ec79/0_0).
 
-CDI and CAI are IICS services that are used for integration projects. Depending on the integration criteria, projects can be built using either CDI or CAI, or a hybrid approach when it would be beneficial to an individual project. 
+CDI and CAI are IICS services that are used for integration projects. Depending on the integration criteria, projects may be more feasible to build using either CDI or CAI. A hybrid approach may be the best fit in some other cases.
 
 ## Cloud Data Integration
 
@@ -32,4 +32,4 @@ CAI is best used for projects that have the following characteristics:
 - Event based / Real time integrations
 - Direct access to APIs
 - Business Processes
-- Composite Services, APIs
+- Composite Services, APIs
\ No newline at end of file

docs/best-practices/flat-file-alternative.md

@@ -55,6 +55,7 @@ following are few things you can consider when choosing between AWS S3 vs Box.
 S3 (and how it fits in AWS system) has a learning curve.
 * If you are already familiar with AWS S3 and already using it, then AWS S3 may be a better alternative.
 * If you are using other AWS services, then AWS S3 will best fit in with those.   
+* The Box Connector in IICS has less granular control over file name and formatting than the S3 Connector. If you have requirements outside of a .csv file with a static file name, you will have to use AWS S3.
 
 ## Training and Experimentation
 
@@ -63,4 +64,4 @@ If using a hosted Secure Agent for training purposes, then we recommend that you
 
 ## Recommendation for using flat file connector
 
-If there are limitations to effectively using AWS S3 or Box instead of flat files, we recommend that you host a Secure Agent on a machine that you manage.
+If there are limitations to effectively using AWS S3 or Box instead of flat files, we recommend that you host a Secure Agent on a machine that you manage.
\ No newline at end of file

docs/best-practices/secure-agent.md → docs/secure-agent.md

-# Secure Agent
+# Table of Contents
+
+- [Secure Agents](#secure-agents)
+- [Costs](#costs)
+- [Responsibilities](#responsibilities)
+- [Recommendations](#recommendations)
+- [Reliability and High Availability](#reliability-and-high-availability)
+- [Managing Out-Of-Memory Errors](#managing-out-of-memory-errors)
+- [Secure Agents for Training Purposes](#secure-agents-for-training-purposes)
+
+# Secure Agents
 
 A Secure Agent is a Java program that runs integration tasks and enables secure communication across the firewall between our organization and 
 IICS. More details can be found [here](https://docs.informatica.com/integration-cloud/cloud-platform/current-version/runtime-environments/runtime-environments/secure-agents.html).
+
 ## Costs
 
 Secure Agents are licensed at a per-Secure-Agent rate.
@@ -31,7 +42,7 @@ Accordingly, make sure configuration files and log files are stored externally t
 The DoIT Integration platform team uses AWS Elastic File System to persist configuration files.
 By doing this, we can destroy and replace our Secure Agent container, or underlying EC2 host, with confidence that the Secure Agent will start and operate in a consistent manner.
 
-## High Availability
+## Reliability and High Availability
 
 While a single Secure Agent is most cost effective, it does introduce a risk if the Secure Agent or underlying host were to fail.
 By running the Secure Agent in a container platform such as AWS Elastic Container Service (ECS), you can make sure that a single Secure Agent is always running.
@@ -47,7 +58,7 @@ For more information on Secure Agents with Cloud Application Integration, please
 
 If running in to errors relating to memory, refer to this [Informatica Knowledge Base Article](https://knowledge.informatica.com/s/article/336913?language=en_US).
 
-## Secure Agent For Training and Learning Purposes
+## Secure Agents For Training Purposes
 
 There are multiple options if you are looking for a Secure Agent for training and learning purposes. 
 * Install a Secure Agent in your local computer for training and learning proposes. Refer to the [Official Installation Guide](https://docs.informatica.com/integration-cloud/cloud-data-integration/current-version/getting-started/installing-secure-agents.html) for instructions on installing Secure Agent locally. Do note that this option will only work on a machine running Windows or Linux.