During this round table we covered the following topics: URL Path Params, Terraform, Nomenclature, Architecture review, Backstage, Docusaurus, and calling lambdas from different sources
Participants
- @John Kilpatrick
- @Tristan Watson
- @Verónica Gutiérrez Estébanez
- @Felix Alonso
- @Leticia Reigada
- @Carlos Andrés Pérez Rodríguez
- @Fernando Prieto
- @Muhammadali Vazhayil
- @Alex Robinson
- @Oscar Bertrand
- @Rafael Guillermo Oelmann Perez
Topics
| Item | Notes/Decisions |
|---|---|
| URL Path Params | Drop path parameters as they are redundant with our token solution. |
| Terraform | Continue to use terraform for all infrastructure. Investigate lambda development with Terraform. |
| Nomenclature | Consensus on the terraform style guide. We will continue to use 2 layer naming convention as this adds context around our services. |
| Architecture review | Team to review the documentation. |
| Backstage | Not mature enough for us to use right now. Has limited gitlab support. We should continue our efforts with documentation with a view to eventually move to Backstage. |
| Docusaurus | A great replacement for confluence where technical documentation is concerned. See the engineering example here. Search is very powerful. We can make sure our documentation is consistent through peer reviews. Powered by Markdown. |
| Call lambdas from different sources | Split into multiple session. Configuration - I appreciate that configuration across AWS isn’t consistent so we should think about how it differs depending on the event type Communication type - I think we should think how the communication type has an influence on our solution (async vs sync) |
Action items
- @John Kilpatrick @Tristan Watson - Document Serverless vs Terraform Lambda development pros and cons.
- [] @Carlos Andrés Pérez Rodríguez @Leticia Reigada @Fernando Prieto @Alex Robinson @Oscar Bertrand @Rafael Guillermo Oelmann Perez - Review microservice documentation.
- @John Kilpatrick - Docusaurus proof of concept for collating readme/docs from all repositories.
- @John Kilpatrick - Documentation Templates