Skip to content

πŸ›  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

​

​

md

    #bf6a34

​

ts
#f44747

​

ts
#569cd6

​

ts
#6a9955

​

ts
#c586c0

BackgroundColor ​

ts
#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

html
<code><moto>eco</moto></code>

​

Add current state of development to desgin box

Boolean

DevState ​

py
`TagsToHeaders: False`

Delete tags once converted to headers. They are stored in a JSON

md

### 🟠 <dev>DesignBox</dev><moto>.Moto</moto>

```md
::: details πŸ›  <dev>&&&</dev>

## DevNotes

-

## DevState

```py
`TagsToHeaders: False`

:::

🟠 ​

md

### 🟩 <dev>DesignBox</dev><eco>.Eco</eco>

```md
::: details πŸ›  <dev>&&&</dev>

## DevNotes

-

## DevState

```py
`TagsToHeaders: False`

:::

🟩 ​

md

### πŸ”» <dev>DesignBox</dev><via>.Via</via>

```md
::: details πŸ›  <dev>&&&</dev>

## DevNotes

-

## DevState

```py
`TagsToHeaders: False`

:::

πŸ”» ​

md

### πŸ’œ <dev>DesignBox</dev><neuro>.Neuro</neuro>

```md
::: details πŸ›  <dev>&&&</dev>

## DevNotes

-

## DevState

```py
`TagsToHeaders: False`

:::

πŸ’œ ​

md

### πŸ”· <dev>DesignBox</dev><beta>.Beta</beta>

```md
::: details πŸ›  <dev>&&&</dev>

## DevNotes

-

## DevState

```py
`TagsToHeaders: False`

:::

πŸ”· ​

md

### πŸ›  <dev>DesignBox.Dev</dev>

```md
::: details πŸ›  <dev>&&&</dev>

## DevNotes

-

## DevState

```py
`TagsToHeaders: False`

:::

πŸ›  ​

md

## <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
py

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, , 0448.jpg dev/StyleGuide.md, , 0448.jpg dev/StyleGuide.md, , 0486.jpg dev/StyleGuide.md, , 0514.jpg dev/StyleGuide.md, , 0548.jpg dev/StyleGuide.md, , 0549.jpg dev/StyleGuide.md, , 0560.jpg dev/StyleGuide.md, , 0594.jpg dev/StyleGuide.md, , 0595.jpg dev/StyleGuide.md, , 0596.jpg dev/StyleGuide.md, , 0596.jpg dev/StyleGuide.md, , 0600.jpg dev/StyleGuide.md, , 1087.jpg dev/StyleGuide.md, , 1095.jpg dev/StyleGuide.md, , 1112.jpg dev/StyleGuide.md, , 1235.jpg dev/StyleGuide.md, , 1324.jpg dev/StyleGuide.md, , 1372.jpg dev/StyleGuide.md, , 1383.jpg dev/StyleGuide.md, , 1384.jpg dev/StyleGuide.md, , 1387.jpg dev/StyleGuide.md, , 1406.jpg dev/StyleGuide.md, , 1409.jpg dev/StyleGuide.md, , 1425.jpg dev/StyleGuide.md, , 1425.jpg dev/StyleGuide.md, , 1449.jpg dev/StyleGuide.md, , 1474.jpg dev/StyleGuide.md, , 1502.jpg dev/StyleGuide.md, , 1502.jpg dev/StyleGuide.md, , 1521.jpg dev/StyleGuide.md, , 1522.jpg dev/StyleGuide.md, , 1527.jpg dev/StyleGuide.md, , 1554.jpg dev/StyleGuide.md, , 1554.jpg dev/StyleGuide.md, , 1572.jpg dev/StyleGuide.md, , 1572.jpg dev/StyleGuide.md, , 1656.jpg dev/StyleGuide.md, , 1658.jpg dev/StyleGuide.md, , 1673.jpg dev/StyleGuide.md, , 1701.jpg dev/StyleGuide.md, , 1707.jpg dev/StyleGuide.md, , 1735.jpg dev/StyleGuide.md, , 1735.jpg dev/StyleGuide.md, , 1749.jpg dev/StyleGuide.md, , 1750.jpg dev/StyleGuide.md, , 1752.jpg dev/StyleGuide.md, , 1752.jpg dev/StyleGuide.md, , 1809.jpg dev/StyleGuide.md, , 1818.jpg dev/StyleGuide.md, , 1819.jpg dev/StyleGuide.md, , 1824.jpg dev/StyleGuide.md, , 1830.jpg dev/StyleGuide.md, , 1855.jpg dev/StyleGuide.md, , 1855.jpg dev/StyleGuide.md, , 1872.jpg dev/StyleGuide.md, , 2010.jpg dev/StyleGuide.md, , 2020.jpg dev/StyleGuide.md, , 2033.jpg dev/StyleGuide.md, , 2279.jpg dev/StyleGuide.md, , 2279.jpg dev/StyleGuide.md, , 2279.jpg dev/StyleGuide.md, , 2323.jpg dev/StyleGuide.md, , 2349.jpg dev/StyleGuide.md, , 2363.jpg dev/StyleGuide.md, , 2363.jpg dev/StyleGuide.md, , 2365.jpg dev/StyleGuide.md, , 2450.jpg dev/StyleGuide.md, , 2525.jpg dev/StyleGuide.md, , 2834.jpg dev/StyleGuide.md, , 2858.jpg dev/StyleGuide.md, , 2880.jpg dev/StyleGuide.md, , 2894.jpg dev/StyleGuide.md, , 2894.jpg dev/StyleGuide.md, , 2917.jpg dev/StyleGuide.md, , 2917.jpg dev/StyleGuide.md, , 2917.jpg dev/StyleGuide.md, , 2933.jpg dev/StyleGuide.md, , 2943.jpg dev/StyleGuide.md, , 2948.jpg dev/StyleGuide.md, , 2948.jpg dev/StyleGuide.md, , 2956.jpg dev/StyleGuide.md, , 3014.jpg dev/StyleGuide.md, , 3014.jpg dev/StyleGuide.md, , 3019.jpg dev/StyleGuide.md, , 3023.jpg dev/StyleGuide.md, , 3042.jpg dev/StyleGuide.md, , 3042.jpg dev/StyleGuide.md, , 3043.jpg dev/StyleGuide.md, , 3043.jpg dev/StyleGuide.md, , 3070.jpg dev/StyleGuide.md, , 3070.jpg dev/StyleGuide.md, , 3087.jpg dev/StyleGuide.md, , 3159.jpg dev/StyleGuide.md, , 3161.jpg dev/StyleGuide.md, , 3161.jpg dev/StyleGuide.md, , 3161.jpg dev/StyleGuide.md, , 3161.jpg dev/StyleGuide.md, , 3166.jpg dev/StyleGuide.md, , 3168.jpg dev/StyleGuide.md, , 3185.jpg dev/StyleGuide.md, , 3217.jpg dev/StyleGuide.md, , 3231.jpg dev/StyleGuide.md, , 3245.jpg dev/StyleGuide.md, , 3270.jpg dev/StyleGuide.md, , 90088.png

Library released under MIT License.