Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/api-playbook/Governance/api_compliance.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ The APIs compliance checklist will be used as part of future Service Standard As
### Checklist
1. The API has corresponding SwaggerHub documentation for all of the API endpoints it exposes.
2. The API has completed the [API specification assessment process](../../api-specifications/assessment_process.md)
3. The API has been developed in Hackney’s preferred tech tech stack, unless otherwise agreed and as per standards defined in our [API playbook](../../api-playbook/).
3. The API has been developed in Hackney’s preferred tech tech stack, unless otherwise agreed and as per standards defined in our [API playbook](../README.md).
4. The API has been developed following the TDD approach and has end-to-end tets in place
- End-to-end tests guide for DynamoDB
- End-to-end tests guide for PostgreSQL
Expand Down
2 changes: 1 addition & 1 deletion docs/api-playbook/Governance/developer_onboarding.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ All APIs must be built in a reusable manner, unless they implement a very specif
We use [SwaggerHub](https://app.swaggerhub.com/organizations/Hackney) to document our APIs and their respective data contracts. All new and existing APIs must have corresponding SwaggerHub documentation. It is the responsibility of the engineers who amend existing APIs to also update the documentation so it is kept up-to-date.
- If you or your team is building new APIs or making changes to existing API endpoints, please request SwaggerHub access so you can amend the specifications documented to ensure they are always up-to-date.

In addition, we also have [API specifications](../../api-specifications/), which capture a summary of the user needs and any other findings related to an API.
In addition, we also have [API specifications](../../api-specifications/README.md), which capture a summary of the user needs and any other findings related to an API.
- A new API specification must be produced for all new APIs.
- The API specification document should link off to the SwaggerHub page that outlines the API contract.
- The API specification should be updated when the API introduces new endpoints or changes to existing functionality.
Expand Down
2 changes: 1 addition & 1 deletion docs/api-playbook/Support/creating_support_doc.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,4 +25,4 @@ To create support documentation that is easy to find and becomes quickly availab
- The item to be included should match the id you have given to the support document created.
- Create a pull request with your changes.

Once the changes are approved and merged, the support documentation will be available in the [API playbook](../../api-playbook/).
Once the changes are approved and merged, the support documentation will be available in the [API playbook](../README.md).
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ The APIs compliance checklist will be used as part of future Service Standard As
### Checklist
1. The API has corresponding SwaggerHub documentation for all of the API endpoints it exposes.
2. The API has completed the [API specification assessment process](../../api-specifications/assessment_process.md)
3. The API has been developed in Hackney’s preferred tech tech stack, unless otherwise agreed and as per standards defined in our [API playbook](../../api-playbook/).
3. The API has been developed in Hackney’s preferred tech tech stack, unless otherwise agreed and as per standards defined in our [API playbook](../../api-playbook/README.md).
4. The API has been developed following the TDD approach and has end-to-end tets in place
- End-to-end tests guide for DynamoDB
- End-to-end tests guide for PostgreSQL
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ We love innovation and are always open to learning, iterating and improving. To
Our preferred BE stack is documented [here](../../api-playbook/Development%20Lifecycle/How%20to%20build%20an%20API/Preferred%20tech%20stack/Readme.md).

### Development standards
All technical members of a project team must familiarise themselves with [Hackney’s development standards](../../ways-of-working/), which follow the Twelve Factor Application methodology. Those define the high level principles to follow when developing a digital product.
All technical members of a project team must familiarise themselves with [Hackney’s development standards](../../ways-of-working/README.md), which follow the Twelve Factor Application methodology. Those define the high level principles to follow when developing a digital product.

### Playbooks

Expand Down Expand Up @@ -63,7 +63,7 @@ To set up your developer workstation, please refer to the Workstation Setup Guid
### Technical ways of working

#### Pull Request process
Hackney’s official pull request process to follow as part of the Software Development Lifecycle can be found [here](../../ways-of-working/).
Hackney’s official pull request process to follow as part of the Software Development Lifecycle can be found [here](../../ways-of-working/README.md).

### API specifications
All APIs must be built in a reusable manner, unless they implement a very specific use case. Any new proposed reusable APIs or changes to the data models of existing ones should follow the [API specification assessment process](../../api-specifications/assessment_process.md).
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Core AWS resources compliance checks

### Context
At Hackney, we follow an infrastructure-as-code (IaC) approach and use Terraform to provision most of our AWS cloud resources. For our APIs, which are Lambda functions exposed via AWS API Gateway, we use the Serverless framework as it significantly speeds up the delivery and resource creation. For more information please refer to [our playbook](../../api-playbook/).
At Hackney, we follow an infrastructure-as-code (IaC) approach and use Terraform to provision most of our AWS cloud resources. For our APIs, which are Lambda functions exposed via AWS API Gateway, we use the Serverless framework as it significantly speeds up the delivery and resource creation. For more information please refer to [our playbook](../../api-playbook/README.md).

From a Development perspective, each project manages its own Terraform files(or Serverless configuration) to provision resources for our microservices and frontend applications. Terraform is then applied automatically as part of the CI/CD pipeline workflow during deployment.

Expand Down
6 changes: 5 additions & 1 deletion docusaurus.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,11 @@ const config = {
// If you aren't using GitHub pages, you don't need these.
organizationName: 'LBHackney-IT', // Usually your GitHub org/user name.
projectName: 'lbhackney-it.github.io', // Usually your repo name.
trailingSlash: false,

// CAUTION! This alters how client routing behaves but NOT the hosting
// provider. See https://github.com/slorber/trailing-slash-guide
// GitHub pages returns 404s when refreshing a page when trailingSlash: false
trailingSlash: true,

onBrokenLinks: 'throw',
onBrokenMarkdownLinks: 'warn',
Expand Down
Loading