mirror of
https://github.com/hasura/graphql-engine.git
synced 2024-12-15 17:31:56 +03:00
dc0dc30a06
## Description [Jira ticket](https://hasurahq.atlassian.net/jira/software/projects/DOCS/boards/19?selectedIssue=DOCS-102). This PR capitalizes Hasura features based on our [feature capitalization guide on the docs wiki](https://hasura.io/docs/wiki/style/hasura-features/). It also introduces some linting by prettier. PR-URL: https://github.com/hasura/graphql-engine-mono/pull/7260 Co-authored-by: Samir Talwar <47582+SamirTalwar@users.noreply.github.com> Co-authored-by: Luca Restagno <59067245+lucarestagno@users.noreply.github.com> Co-authored-by: hasura-bot <30118761+hasura-bot@users.noreply.github.com> Co-authored-by: Gil Mizrahi <8547573+soupi@users.noreply.github.com> Co-authored-by: Stefano Magni <173663+NoriSte@users.noreply.github.com> Co-authored-by: Daniel Harvey <4729125+danieljharvey@users.noreply.github.com> Co-authored-by: Abby Sassel <3883855+sassela@users.noreply.github.com> Co-authored-by: Daniele Cammareri <5709409+dancamma@users.noreply.github.com> Co-authored-by: Brandon Martin <40686+codedmart@users.noreply.github.com> GitOrigin-RevId: 5946f313cb44c639fac61e6c7fb44f704ee2a709
30 lines
1.6 KiB
Plaintext
30 lines
1.6 KiB
Plaintext
---
|
|
title: General
|
|
description: General documentation style
|
|
sidebar_position: 1
|
|
keywords:
|
|
- hasura
|
|
- style
|
|
- general
|
|
slug: general
|
|
---
|
|
|
|
# General Style Points
|
|
|
|
- Try to include a `TL;DR` block for feature documentation at the top of the doc to summarise it as much as possible.
|
|
- Hasura features should be proper noun _title case_ to differentiate from any other uses of the word Eg: Console,
|
|
Metadata, Migrations, Actions, Events, etc.
|
|
- Keep in mind you are trying to write for beginner, intermediate and advanced users.
|
|
- All lines in markdown should break at **120 characters** for better readability in IDEs. 120 is useful because it
|
|
still allows side-by-side editing on most screens and closely matches the line length of the final output page at max
|
|
width.
|
|
- Add appropriate cross-links in content to assist users.
|
|
- If you refer to some functionality that is documented in some other docs page, add a link to that page.
|
|
- If you have a statement like "create a relationship between tables X and Y ...", make "create a relationship"
|
|
a link to the `Create relationships` page.
|
|
- Try to make each section within a page self-sufficient. i.e. avoid structuring all pages as step-by-step guides unless
|
|
it really is the intent. This ensures that we can refer to sections externally (from other docs pages, Console, etc.)
|
|
and expect that the user will be able to follow the section without being lost on the context that was set in earlier
|
|
sections of the page. Adding statements such as "As we have described in the above section ..." might help to set up
|
|
the needed context.
|