Skip to content

Commit c4c17e1

Browse files
author
Brylie Christopher Oxley
committed
Mention ambiguity and adjust grammar
1 parent 79c26a5 commit c4c17e1

File tree

1 file changed

+5
-5
lines changed
  • content/contributing-code/javascript-guidelines

1 file changed

+5
-5
lines changed

content/contributing-code/javascript-guidelines/contents.lr

+5-5
Original file line numberDiff line numberDiff line change
@@ -6,22 +6,22 @@ title: JavaScript Guidelines
66
---
77
description:
88

9-
These JavaScript Guidelines (style guide) help the community to focus on the intent of the code and work together with a minimum of friction.
9+
These JavaScript Guidelines (style guide) help the community focus on the code's intent and work together with a minimum of friction.
1010
---
1111
body:
1212

1313
## Purpose
1414

15-
These JavaScript Guidelines help developers who are new to the community and want to make a contribution to the Creative Commons open-source ecosystem.
15+
These JavaScript Guidelines help developers who are new to the community and want to contribute to the Creative Commons open-source ecosystem.
1616

1717
## Philosophy
18-
A few philosophical guidelines can stand in place of a thousand narrow rules.
18+
A few philosophical guidelines can stand in place of a thousand narrow rules. These guidelines are not intended as absolute (black or white) truths but rather lenses to focus our vision when faced with subtle shades of ambiguity.
1919

2020
### Simplicity
2121

2222
> Use and build only what is _essential_ to a project.
2323
24-
Projects can easily grow beyond their essence by taking on dependencies and features that are not central to their purpose. Keep the essential purpose in mind as a project evolves. Take on only what is needed and only when the need arises.
24+
Projects can quickly grow beyond their essence by taking on dependencies and features that are not central to their purpose. Keep the essential goal in mind as a project evolves. Take on only what is needed and only when the need arises.
2525

2626
### Stability
2727

@@ -47,7 +47,7 @@ Code is read more often than it is written. Code is written for humans, not mach
4747

4848
## Pragmatics
4949

50-
The following sections outline how we've put the philosophy into action. See the [creativecommons/chooser](https://github.com/creativecommons/chooser) project for an example of how we have applied the recommendations below.
50+
The following sections outline how we've put the philosophy into action. See the [creativecommons/chooser](https://github.com/creativecommons/chooser) project to exemplify how we have applied the recommendations below.
5151

5252
### Code formatting
5353

0 commit comments

Comments
 (0)