π Style Guide β
https://developers.google.com/style
Classic Style β
The writer can see something that the reader has not yet noticed, and he orients the reader's gaze so that she can see it for herself.
You're already performing beta elements, you've just never labelled them before.
Beta is a description
They are currently capable of performing all beta, there are no prerequisites to performing beta. Know how beta works requires knowledge of many fields of science: geology, kinesiology, biology, psychology, physics, meteorology...
Steven Pinker The Sense of Style: A Thinking Person's Guide to Writing in the 21st Century
Cambridge grammar 2002 Huddleston
Show don't tell
Reader and writer are intellectual equals
β
WARNING
It's easy to get stuck on the linguistics and naming. You can think about it for hours while in the land. While sitting in front of a computer your time is better spent typing, not thinking about increasing the clarity. Just get it out, then you can edit.
(Woods)InteadOf([Forest, Plantation]) β
- Bushes are wood
- Flowers are not wood
"Planting" β
Planting= Planting Industry Planting= Putting a Tree in the Ground
"Plant" β
Try to avoid PlantPlant plant a plant in the ground. InsertPlant
InsertPod
Plant= Put a Tree in the Ground
- Put
Plant= Organism from Plantae
Keep it G β
Euphemisms undermine Put(Plant) and open it up to unnecessary criticism
- CreamyLand
- "Cream out"
- "Slut in"
β
No Acronyms
Write complete sentences.
Point form is lazy. Think about all the coding documentation which is not easy to read. Too formal, too concise, humans don't process language like computers, point of view matters.
β
- PascaleCase
β
French, English
β
You, not them β
Second person instead of 3rd person
Article β
"a" not "the" β
The definite article "the" is used before a noun to indicate that the identity of the noun is known to the reader. The indefinite article "a, an" is used before a noun that is general or when its identity is not known.
Good
Obstacle within a Hole
Bad
Obstacle within the Hole
Tense β
Remember Punctuation β
Periods
Gender Neutral Pronouns β
Person β
https://developers.google.com/style/person
β
β
#bf6a34
β
#f44747
β
#569cd6
β
#6a9955
β
#c586c0
BackgroundColor β
#1f1f1f
Icon β
Icons are only used to represent Objects or Functions.
!Icon β
Concept, Object Property
MotoTimeline is orange as a header but it is not prefixed with an Icon.
Incorrect Syntax
π
Only the π object is prefixed with an icon. ArmPut is orange but has no icon
π
Literal or Metaphorical β
Tree π² β
Face Icons β
- Emotion
- Sleep
Purpose(Icon) β
- Visual Search
- For planters to use the Icons
- Each Icon can be easily handwritten, since electronics don't do well in extreme weather, in terms of breaking and in UX. You can't easily view a screen in summer sun, or rain, definitely not in snow.
The BetaModules are aliased as Icons.
?
When is it useful for Icons to be monochrome outlines?
Ambifix for Page Title β
Postfix β
- Postfix for
Prefix β
- Prefix for
Icon Only β
- Which renderer to use for Icons in images?
- No shading
eco
<code><moto>eco</moto></code>
β
Add current state of development to desgin box
Boolean
DevState β
`TagsToHeaders: False`
Delete tags once converted to headers. They are stored in a JSON
### π <dev>DesignBox</dev><moto>.Moto</moto>
```md
::: details π <dev>&&&</dev>
## DevNotes
-
## DevState
```py
`TagsToHeaders: False`
:::
π β
### π© <dev>DesignBox</dev><eco>.Eco</eco>
```md
::: details π <dev>&&&</dev>
## DevNotes
-
## DevState
```py
`TagsToHeaders: False`
:::
π© β
### π» <dev>DesignBox</dev><via>.Via</via>
```md
::: details π <dev>&&&</dev>
## DevNotes
-
## DevState
```py
`TagsToHeaders: False`
:::
π» β
### π <dev>DesignBox</dev><neuro>.Neuro</neuro>
```md
::: details π <dev>&&&</dev>
## DevNotes
-
## DevState
```py
`TagsToHeaders: False`
:::
π β
### π· <dev>DesignBox</dev><beta>.Beta</beta>
```md
::: details π <dev>&&&</dev>
## DevNotes
-
## DevState
```py
`TagsToHeaders: False`
:::
π· β
### π <dev>DesignBox.Dev</dev>
```md
::: details π <dev>&&&</dev>
## DevNotes
-
## DevState
```py
`TagsToHeaders: False`
:::
π β
## <dev>Beta Symbols</dev>
```md
π·
π
π©
π»
π
β
How many links is too many?
Every paragraph should have a link
Grandiosity β
Oversell β
Scale β
- Number of Plants
- Scope
- Timeline
Urgency β
Hero β
Save the Day
Planters are Heros. Many people commented on @antmos Instagram that he was a hero. People already naturally think it.
Via β
Should "via" be used as natural language? "Get to the next page via the link at the bottom of the page"
β
β
Definition β
Brief Definition in Blockquote avoid using Via adjectives and other BetaModules
Taxonomy β
Moto.SubMoto β
TIP
Taxonomy will be useful for D3.js
It doesn't matter if nobody looks at it.
- Subset of Moto
Moto.SuperMoto β
- Superset of Moto
ArmSwing.SuperMoto = ArmMoto
Images β
- Description of a useful image in mind's eye
- Link to image
- Link to PaperPhoto. Draw a rough sketch of the Moto, be sure to clearly Tag the sketch in the Head of the paper.
- Capture then Upload the Photo with Phone
Moto.Purpose β
The purpose is usually affect other BetaElements
Moto.AnteMoto β
Syntax: Moto.AnteMoto
- How they transition to each other
Moto.PostMoto β
Moto.Via β
- How does this Moto interface with Eco?
- Where in the Via is this Moto performed?
Moto.Eco β
Where in Eco is this Moto performed and on what EcoFactor. Put "the ground" if necessary. Nothing is too obvious in formal languages!
Moto.Neuro β
- Control Flow Statements for alternative moves
Moto.Error β
- Any errors in ControlFlow
- MotoExecutionError
- Error which is caused by Eco
- Soil Collapse
- Wood breaking
- Error Recovery if possible
β
β
β
β
β
β
β
β
β
π
DevNotes β
- Use Code snippets to write abbreviated names to insert Tags or ElementName
PageTags
- "Dev.Breadcrumb"
- "Dev.Carousel"
- "Dev.DataType.Array"
- "Dev.DataType.Boolean"
- "Dev.GridView"
- "Dev.HeroImage"
- "Dev.ImageLayer"
- "Dev.LevelOfAbstraction"
- "Dev.LevelOfAbstraction.AbstractIdea"
- "Dev.LevelOfAbstraction.ConcreteIdea"
- "Dev.LevelOfDetail"
- "Dev.LevelOfDetail.ComplexifyDetail"
- "Dev.LevelOfDetail.LessIsMore"
- "Dev.LevelOfDetail.SimplifyDetail"
- "Dev.LevelOfDetail.SimplifyDetail.CropDiagram"
- "Dev.PageLayout"
- "Dev.PageLayout.CloseUp"
- "Dev.RelationByAlignment"
- "Dev.RelationByProximity"
- "Dev.StyleGuide"
dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, , dev/StyleGuide.md, ,