Commits (2)
......@@ -57,7 +57,7 @@ described viewing code as “not real” to be a trap. Their small code base
quickly grew larger than anticipated and their early technical decisions would
have long lasting ramifications.
![Diagram matching above description](/architecture_reviews/data_act_pilot/data-act-diagram.png)
![Diagram matching above description]({{site.baseurl}}/architecture_reviews/data_act_pilot/data-act-diagram.png)
## Simplicity avoids scary
......@@ -11,5 +11,5 @@ interesting design decisions from existing projects.
## Projects
* [DATA Act Pilot: Simplicity is Key](/architecture_reviews/data_act_pilot)
* [Micro-purchase: Do one thing well](/architecture_reviews/micro_purchase)
* [DATA Act Pilot: Simplicity is Key]({{site.baseurl}}/architecture_reviews/data_act_pilot)
* [Micro-purchase: Do one thing well]({{site.baseurl}}/architecture_reviews/micro_purchase)
......@@ -107,7 +107,7 @@ for instance, a NullBid object with similar methods to the Bid model is
returned when the auction’s winning bid is not available. Do you notice the
![Objects playing the role of Controller, Service, Validator, and Rule](/architecture_reviews/micro_purchase/roles.png)
![Objects playing the role of Controller, Service, Validator, and Rule]({{site.baseurl}}/architecture_reviews/micro_purchase/roles.png)
## Population control
As with any design decision, the PORO approach has trade-offs. While we gain
......@@ -199,7 +199,7 @@ solution? Service Objects! Each interface (web UI, API versions) call into
shared Service Objects (which contains all of the shared code); the controller
just needs to convert the input/output as appropriate.
![Both API and HTML controllers use PlaceBid Service](/architecture_reviews/micro_purchase/service.png)
![Both API and HTML controllers use PlaceBid Service]({{site.baseurl}}/architecture_reviews/micro_purchase/service.png)
## Other applications
While we didn’t want to create a single-page app, we knew we’d leverage
......@@ -4,10 +4,10 @@ title: Front-End Disciplines
# Front-End Disciplines
## Related topics
* [CSS](/css)
* [JavaScript](/javascript)
* [Web Components](/web-components)
* [Security](/security)
* [CSS]({{site.baseurl}}/css)
* [JavaScript]({{site.baseurl}}/javascript)
* [Web Components]({{site.baseurl}}/web-components)
* [Security]({{site.baseurl}}/security)
## What is front end?
......@@ -3,29 +3,29 @@ title: 18F Engineering Practices Guide
A set of guidelines and best practices for an awesome engineering team
* [Front-End Disciplines](/frontend)
* [Third-Party Integrations](/integrations)
* [Workflow Best Practices](/workflow)
* [Example Workflows](/example_workflows)
* [Project Setup](/project_setup)
* [Architecture Reviews](/architecture_reviews)
* [Accessibility Scanning using AccessLint](/accessibility_scanning)
* [Feedback Guide](/people)
* [Continuous Deployment](/continuous_deployment)
* [Datastore Selection Guidance](/datastore_selection)
* [Security](/security)
* [Code Review](/code_review)
* [Development Environments](/development_environments)
* [Incident Reports](/incident_reports)
* [Polls](/polls)
* [Project Setup](/project_setup)
* [Tech Leads](/tech_leads)
* [Front-End Disciplines]({{site.baseurl}}/frontend)
* [Third-Party Integrations]({{site.baseurl}}/integrations)
* [Workflow Best Practices]({{site.baseurl}}/workflow)
* [Example Workflows]({{site.baseurl}}/example_workflows)
* [Project Setup]({{site.baseurl}}/project_setup)
* [Architecture Reviews]({{site.baseurl}}/architecture_reviews)
* [Accessibility Scanning using AccessLint]({{site.baseurl}}/accessibility_scanning)
* [Feedback Guide]({{site.baseurl}}/people)
* [Continuous Deployment]({{site.baseurl}}/continuous_deployment)
* [Datastore Selection Guidance]({{site.baseurl}}/datastore_selection)
* [Security]({{site.baseurl}}/security)
* [Code Review]({{site.baseurl}}/code_review)
* [Development Environments]({{site.baseurl}}/development_environments)
* [Incident Reports]({{site.baseurl}}/incident_reports)
* [Polls]({{site.baseurl}}/polls)
* [Project Setup]({{site.baseurl}}/project_setup)
* [Tech Leads]({{site.baseurl}}/tech_leads)
### Language Guides
* [Language Selection Guidance](/language_selection)
* [JavaScript](/javascript)
* [Node.js](/nodejs)
* [Python](/python)
* [Ruby](/ruby)
* [CSS](/css)
* [Language Selection Guidance]({{site.baseurl}}/language_selection)
* [JavaScript]({{site.baseurl}}/javascript)
* [Node.js]({{site.baseurl}}/nodejs)
* [Python]({{site.baseurl}}/python)
* [Ruby]({{site.baseurl}}/ruby)
* [CSS]({{site.baseurl}}/css)
......@@ -9,4 +9,4 @@ consistent JS across 18F. The styleguide should be treated as a guide
— rules can be modified according to project needs.
## Related topics
* [Node.js](/nodejs)
* [Node.js]({{site.baseurl}}/nodejs)
......@@ -4,7 +4,7 @@ title: Node.js Development Guide
# Node.js Development Guide
## Related topics
* [JavaScript](/javascript)
* [JavaScript]({{site.baseurl}}/javascript)
## Introduction
......@@ -28,5 +28,5 @@ Giving constructive feedback to a top performer is not nitpicking, it is actuall
18F, as a part of GSA, has a mature [performance management and recognition system](https://insite.gsa.gov/portal/content/500278).
This includes an end-of-year performance assessment.
* [2016 Assessment Guide](/2016-Assessment-Guide)
* [2017 Assessment Guide](/2017-Assessment-Guide)
* [2016 Assessment Guide]({{site.baseurl}}/2016-Assessment-Guide)
* [2017 Assessment Guide]({{site.baseurl}}/2017-Assessment-Guide)
......@@ -5,6 +5,6 @@ Here we collect (publicly visible) survey and poll results. In particular, we
create quick write-ups to summarize and contextualize the results.
## Polls
* [Silos and Soundness, Oct '16](/polls/silos_and_soundness_2016_10)
* [NodeJS for Backend, Dec '16](/polls/nodejs_for_backend_2016_12)
* [Third-Party Tool Experience, Feb '18](/polls/third_party_xp_2018_02)
* [Silos and Soundness, Oct '16]({{site.baseurl}}/polls/silos_and_soundness_2016_10)
* [NodeJS for Backend, Dec '16]({{site.baseurl}}/polls/nodejs_for_backend_2016_12)
* [Third-Party Tool Experience, Feb '18]({{site.baseurl}}/polls/third_party_xp_2018_02)
......@@ -33,7 +33,7 @@ particularly for the pocket of engineers on the low end of the scale.
* The ability to use continuing ed funds for
* More [architecture reviews](/architecture_reviews)
* More [architecture reviews]({{site.baseurl}}/architecture_reviews)
We're also exploring
......@@ -3,7 +3,7 @@ title: Third-Party Tool Experience, Feb ‘18
# Third-Party Tool Experience, Feb ‘18
As we've begun to [define](/integrations/) a standard set of third-party
As we've begun to [define]({{site.baseurl}}/integrations/) a standard set of third-party
services we use in our apps, we wanted to measure existing familiarity. This
will help us determine where we should focus documentation and training
efforts. We had 29 responses from a pool of roughly 65.
......@@ -12,7 +12,7 @@ around deployments, git etiquette, and similar workflow conventions.
test completion should be a requirement for deployment.
* Generally, **CI should perform deployments**. This ensures the deployments
are repeatable and don’t rely on individual development environments. See
our [documentation on continuous deployment](/continuous_deployment) for
our [documentation on continuous deployment]({{site.baseurl}}/continuous_deployment) for
details on how to set this up.
* Deployments should be **zero-downtime**, achievable through tools like
“autopilot” (see the above docs for more detail).
......@@ -28,8 +28,8 @@ around deployments, git etiquette, and similar workflow conventions.
Git is our version control system of choice and GitHub is our current
repository platform, but how to use these tools can be spelled out in a bit
more detail. Note that we are looking to consolidate this with our existing
documentation on [code review](/code_review) and [example
documentation on [code review]({{site.baseurl}}/code_review) and [example
### "Must"s