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 src/views/docs/en/about/contribute.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Architect is an open source project and you can totally help out! Contributing d

We are always happy to review and potentially accept pull request to Architect repositories. In general, we suggest opening an issue and starting a discussion in the [Discord](https://discord.gg/y5A2eTsCRX) before you embark on any large project, as there may be requirements or considerations that you may not be aware of in advance.

If you have a larger problem to solve or idea for a new feature, please file an issue for community discussion. If you have a time-sensitive problem and need to talk things through, you can almost always find someone online in our [Discord](https://discord.gg/y5A2eTsCRX). (It's also a great place to socialize new ideas and to solicit help on how to model specific [Functional Web App (FWA)](https://fwa.dev) patterns.)
If you have a larger problem to solve or idea for a new feature, please file an issue for community discussion. If you have a time-sensitive problem and need to talk things through, you can almost always find someone online in our [Discord](https://discord.gg/y5A2eTsCRX). (It's also a great place to socialize new ideas and to solicit help on how to model specific functional web app patterns.)

Please help us by making it easy for us to help you! If you are experiencing a bug, please have a reduced test case and steps to reproduce prepared. In our process, the first step to resolution is to create a failing test case so we can ensure there are no future regressions. By having a reduced case (even just an example project) and steps to reproduce, you will dramatically reduce the time to getting your bug fixed.

Expand Down
2 changes: 1 addition & 1 deletion src/views/docs/en/get-started/detailed-aws-setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -176,7 +176,7 @@ Where that is not possible, we recommend using AWS Lambda's provided, *non-bundl

### Architect's AWS SDK strategy

A core goal of Architect is to make building [Functional Web Apps](https://fwa.dev) simpler, and an important aspect of that objective is to help (automatically) manage the many dependencies in use across your Lambdas, whether your project has one or one hundred of them.
A core goal of Architect is to make building functional web apps simpler, and an important aspect of that objective is to help (automatically) manage the many dependencies in use across your Lambdas, whether your project has one or one hundred of them.

However, in the of AWS SDK, AWS manages that dependency within the Lambda environment. For the aforementioned reasons, Architect does not attempt to automatically manage or include any version of AWS SDK in the resources it manages on your behalf.

Expand Down
2 changes: 1 addition & 1 deletion src/views/docs/en/get-started/quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ category: Get started
description: Get started quickly with Architect
---

> Architect is a simple framework for building and delivering powerful [Functional Web Apps (FWAs)](https://fwa.dev) on AWS
> Architect is a simple framework for building and delivering powerful functional web apps on AWS

## Create a new project

Expand Down
4 changes: 2 additions & 2 deletions src/views/docs/en/get-started/why-architect.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,12 +4,12 @@ category: Get started
description: Why is Architect important to you?
---

> Architect provides everything you need to build massively scalable [Functional Web Apps (FWAs)](https://fwa.dev) with low code, clear and terse config, and zero ceremony
> Architect provides everything you need to build massively scalable functional web apps with low code, clear and terse config, and zero ceremony


## The best developer experience

Building a functional web app can be fraught with complex vendor arcana and market noise. This is where Architect comes in. Architect is an opinionated developer experience (DX) for building database backed web apps with AWS. We remove all the noise and friction to building FWAs. We prioritize speed with fast local dev, smart configurable defaults and flexible Infrastructure as Code. And then we get out of your way so you can focus on business logic instead of glue code and only pay for services while in use, on-demand, and otherwise _scale to zero_.
Building a functional web app can be fraught with complex vendor arcana and market noise. This is where Architect comes in. Architect is an opinionated developer experience (DX) for building database backed web apps with AWS. We remove all the noise and friction to building functional web apps. We prioritize speed with fast local dev, smart configurable defaults and flexible Infrastructure as Code. And then we get out of your way so you can focus on business logic instead of glue code and only pay for services while in use, on-demand, and otherwise _scale to zero_.


### Work locally
Expand Down
2 changes: 1 addition & 1 deletion src/views/docs/en/guides/backend/events-and-queues.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ sections:

## Overview

Background tasks are a common workload and perfect for [Functional Web Apps](https://fwa.dev). They reinforce event-driven architecture and allow you to perform asynchronous work across a distributed system. These functions are well suited for processes that don't require an immediate response, or are too resource intensive for a single function.
Background tasks are a common workload and perfect for functional web apps. They reinforce event-driven architecture and allow you to perform asynchronous work across a distributed system. These functions are well suited for processes that don't require an immediate response, or are too resource intensive for a single function.

Architect has three main primitives of background functions:
- [@events](/docs/en/reference/arc-pragmas/@events) - A pub/sub service that uses SNS.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ Define resources in a more verbose format to configure custom Lambda source dire

## Use cases

- Migrate existing repos to the [Functional Web App pattern](https://fwa.dev)
- Migrate existing repos to the functional web app pattern
- Use frontend frameworks that have their own folder requirements
- Better enable local code transpilation by pointing to generated `./dist` directories

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: Architect dependency structure and hydration

## Overview

[Functional Web Apps](https://fwa.dev) have both project-level dependencies and individual function-level dependencies.
Functional web apps have both project-level dependencies and individual function-level dependencies.

Project-level dependencies are defined at the root of the project, and may include things like developer dependencies.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Architect logs to [AWS CloudWatch](https://aws.amazon.com/cloudwatch/).

### See also

- CloudWatch captures many metrics from [Functional Web App](https://fwa.dev) primitives, especially [API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-metrics-and-dimensions.html)
- CloudWatch captures many metrics from functional web app primitives, especially [API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-metrics-and-dimensions.html)
- [X-Ray](https://aws.amazon.com/xray/) offers deeper service call introspection capabilities
- There are many third party tools to further extend your app with structured logs

Expand Down
3 changes: 1 addition & 2 deletions src/views/docs/en/guides/plugins/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ another-private-plugin # loads from `foo/index.js`

## Authoring plugins

Architect provides a suite of workflows, conventions, and optimized defaults for building excellent [Functional Web Apps][fwa] with AWS. Architect plugins enable developers to extend (or override) this functionality in a variety of ways with interfaces into both workflows and resource creation.
Architect provides a suite of workflows, conventions, and optimized defaults for building excellent functional web apps with AWS. Architect plugins enable developers to extend (or override) this functionality in a variety of ways with interfaces into both workflows and resource creation.

To create a fresh plugin, you can run `npx arc create --plugin my-plugin-name`

Expand Down Expand Up @@ -111,7 +111,6 @@ my-private-macro
[manifest]: ../../get-started/project-manifest
[deployment]: ../developer-experience/deployment
[macros]: #macros
[fwa]: https://fwa.dev
[hydrate]: ../../reference/cli/hydrate
[deploy]: ../../reference/cli/deploy
[init]: ../../reference/cli/init
2 changes: 1 addition & 1 deletion src/views/landing/elements/why-architect.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ export default function WhyArchitect ({ html }) {
<h2 class="text5 leading1 tracking-2 font-medium mbs0 mbe4">Why <span class="font-bold">Architect</span>?</h2>

<p class="text1 tracking-1 measure">
Architect provides everything you need to build massively scalable <a class="underline" href="https://fwa.dev">Functional Web Apps</a> on AWS with low code, clear and terse config, and zero ceremony.
Architect provides everything you need to build massively scalable functional web apps on AWS with low code, clear and terse config, and zero ceremony.
</p>

<section class="grid col-1 gap4 mb5">
Expand Down
Loading