graphql-engine/docs/wiki/style/semantics.mdx

---
title: Semantics
description: Semantics in documentation
keywords:
  - hasura
  - style
  - images
slug: semantics
---

# Semantics

- Write in the second person tense eg: `you`, `your`, and `we`, `our`. Instead of `the user`, `users` or `customers`.
- Use the word "directory" instead of "folder"
docs: wiki style section WIP ## Description ✍️ Adding a style section to the documentation wiki. This is a distillation and continuation of the notes started by @marionschleifer and @rikinsk at https://docs.google.com/document/d/1lD7IVEjtv5Sf9BaVqzefLywG-kNpuM40I84ThIUSmwg/edit * _Everything is very much in a WIP stage._ * Everything is on one page for now, but if it warrants it, each sections could be broken out into separate parts under a main `style` section. @robertjdominguez Please let me know your thoughts too. Anyone please feel free to edit and push to this branch. - Sean PR-URL: https://github.com/hasura/graphql-engine-mono/pull/4642 Co-authored-by: parklifeio <33491775+parklifeio@users.noreply.github.com> Co-authored-by: Rob Dominguez <24390149+robertjdominguez@users.noreply.github.com> GitOrigin-RevId: 48a26500114efcef22278d4e673ce0289bd7d7db 2022-06-23 12:44:03 +03:00			`---`
			`title: Semantics`
			`description: Semantics in documentation`
			`keywords:`
			`- hasura`
			`- style`
			`- images`
			`slug: semantics`
			`---`

			`# Semantics`

docs: add prettier PR-URL: https://github.com/hasura/graphql-engine-mono/pull/9923 GitOrigin-RevId: 94038efe5768b63f38dfb447bc315ae5f7185c43 2023-07-21 15:50:50 +03:00			- Write in the second person tense eg: `you`, `your`, and `we`, `our`. Instead of `the user`, `users` or `customers`.
			`- Use the word "directory" instead of "folder"`