π Style Guide β
https://developers.google.com/style
Mindset β
- Openness
- Open Source
- Anyone can be a plantor
- Kindness
- "the quality of being generous, helpful, and caring about other people"
- No crusty vet
- All on the same team
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
Semantics β
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 PlantaBeta and open it up to unnecessary criticism
- CreamyLand
- "Cream out"
- "Slut in"
LevelOfDetail β
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.
ElementName β
- PascaleCase
Bilingual β
French, English
Grammar β
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
Color β
β
#bf6a34
β
#f44747
β
#569cd6
β
#6a9955
β
#c586c0
BackgroundColor β
#1f1f1f
Ikon β
Ikons are only used to represent Objects or Functions.
(ElementGroupName + BetaIkon) β
Initials like ByrneEuklid
β π© E of EKOS π» V of VIA π oo of MOTOR π ANIMA
!Ikon β
Concept, Object Property
MOTONTimeline is orange as a header but it is not prefixed with an Ikon.
Incorrect Syntax
π
Only the π object is prefixed with an ikon. ArmPut is orange but has no ikon
π
PLANTABETA_IKON β
KlimBeta has its own Ikon too
Betaglot too
Custom Ikon
Plantors have access to all the ElementGroupIkons
Groups of Animons
Literal or Metaphorical β
Tree π² β
Face Ikons β
- Emotion
- Sleep
Purpose(Ikon) β
- Visual Search
- For plantors to use the Ikons
- Each Ikon 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 ElementGroups are aliased as Ikons.
?
When is it useful for Ikons to be monochrome outlines?
Ambifix for Page Title β
Postfix β
- Postfix for
Prefix β
- Prefix for
DesignBox β
Add current state of development to DesignBox
Links β
How many links is too many?
Every paragraph should have a link
"via" in Natural Language β
Should "via" be used as natural language? "Get to the next page via the link at the bottom of the page"
ElementPageDesign β
Custom CSS β
π &&&
- "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"