TELUS Reference Architecture Documentation
Why does this exist?
This wiki is the source of truth for all technical knowledge, software specifications, standards and architecture evolution for TELUS.
The goal of the document is to track and discuss software standards, tooling and practices within TELUS. You are welcome to contribute and suggest changes. Please follow the contribution guidelines and keep in mind that this repository is open source.
Who is this for?
What is the structure?
This is a public and open source repository. Articles are written in Markdown on topics in the following categories:
Documentation is meant to be thin and simple. Members should be able to quickly and easily understand the whys, whats and hows of any part of our software standards.
How to take part?
Because we love our customers and we love our technology, we are evolving it, in full transparency!
We do all of this in public to truly embrace our customer first principles
In order to achieve this, we ensure no sensitive content is included, such as:
To ensure open collaboration and support for wiki contributions, a few avenues are made available:
Technology Forum
The Technology Forum is the official discussion board for conversations around
technology solutions, ideas, issue escalations, questions, knowledge sharing,
and Reference Architecture evolution.
Since Reference Architecture is open source, we separated Technology Forum into its own private repository for deep technical discussions and confidential information.
Open Contribution
Use GitHub to create pull-requests, start discussions, and contribute to active issues.
Your contributions should also be addressed in The Technology Forum in order to be considered for adoption.
If you are ready to start contributing, here are some things to keep in mind:
docs(<scope>): added/updated standards about <scope>
.style(<scope>): fix grammar issues in <scope> docs
.If you want to make sure your changes will pass our CircleCI steps, you might want to run things locally:
npm run lint
In order to setup everything needed to run all of the checks locally, please run the script below. This will install locally all of the dependencies needed and mirror the CI setup:
npm run setup-local
All topics MUST adhere to the format outlined in this template
Using the GitHub repository itself, rather than the "GitHub Wikis" feature, or other "Wiki" software ensures:
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.