Skip to content

Commit

Permalink
prettier fix
Browse files Browse the repository at this point in the history
  • Loading branch information
tukib committed Dec 6, 2023
1 parent f155dc9 commit e2bb1e8
Showing 1 changed file with 33 additions and 22 deletions.
55 changes: 33 additions & 22 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,57 +52,66 @@ This upgrade process is written for a major version upgrade with breaking change
1. Clean up and migrate any incompatible build flags
1. Create PR on new `topic branch` and merge with standard process


## Content Guide

### General

1. Only create articles with the intention to provide a majority of the info. Empty articles or placeholder articles should not be created.
1. All articles should pertain to hackmud, its lore, or its mechanics.
1. Articles should not be created pertaining to the developers, players, or any other real life person.
1. All articles relating to mechanics should contain content that is currently in game. Articles should not contain historic or removed info.
1. All articles are in markdown format, using the .mdx file extension.
1. All articles should pertain to hackmud, its lore, or its mechanics.
1. Articles should not be created pertaining to the developers, players, or any other real life person.
1. All articles relating to mechanics should contain content that is currently in game. Articles should not contain historic or removed info.
1. All articles are in markdown format, using the .mdx file extension.
1. Any game text content/output should not be corrected for formatting, spelling, or grammar. If information does not pertain to the article, omitting the lines and replacing them with "\<lines omitted\>" is acceptable.
1. When in doubt, infer appropriate styling/content from previously written articles. If there are still questions regarding styling or content, list these in a separate issue so that they can be addressed for content guide improvements.

### Community

1. Articles detailing or describing user scripts are not allowed.
1. Articles about third party programs are not allowed. Examples include Autohotkey, Sandboxie, JS libraries, etc.
1. Articles that violate the hackmud discord rules or volunteer code of conduct are not permitted.

### Article Titles

1. Capitalization of in game upgrades, corporations, or entities should follow in-game styling and capitalization.

### Writing
1. The overall purpose of an article is to document facts. Speculation should be left out of articles. Citations for information are not required but may be requested during the Pull Request review process.
1. All articles should be written in third person with no referential nouns (e.g. you, your). An exception to this is for Tutorials, FAQs, and Writeups.

1. The overall purpose of an article is to document facts. Speculation should be left out of articles. Citations for information are not required but may be requested during the Pull Request review process.
1. All articles should be written in third person with no referential nouns (e.g. you, your). An exception to this is for Tutorials, FAQs, and Writeups.
- Bad Example: `EZ_21 is one of the first upgrades you could find.`
- Good Example: `EZ_21 is a tier 1 lock. It is commonly found in t1 NPCs.`
1. Tutorial info should only be included in dedicated Tutorials, FAQs, and Writeups.
1. Tutorial info should only be included in dedicated Tutorials, FAQs, and Writeups.
1. Articles should only contain information pertaining to content currently implemented in hackmud. Historic or planned content should not be added.
- Bad Example: `Previously, in sys.access_log, there would be NPCs that connect to users. These were called Account NPCs.`
1. When including example code or scripts, they should be added in the markdown inside of a code block with the proper syntax highlighting.
1. When including example code or scripts, they should be added in the markdown inside of a code block with the proper syntax highlighting.

```JS
function(context,args){
return `D:)`
}
```

#### Spelling
1. Articles should be written using American English.

1. Articles should be written using American English.

#### Capitalization
1. When referring to upgrades do not capitalize them as proper nouns.
1. The name hackmud is always lowercase.
1. Even at the start of a sentence, a word or upgrade that should be lowercase is still lowercase.

1. When referring to upgrades do not capitalize them as proper nouns.
1. The name hackmud is always lowercase.
1. Even at the start of a sentence, a word or upgrade that should be lowercase is still lowercase.

### Headings
1. All headings should start at 2 `#`s and increment as needed.

1. All headings should start at 2 `#`s and increment as needed.
1. Headings with 1 `#` are reserved for the auto-generated article title.
1. Headings should use sentence capitalization and not title capitalization.
1. Exceptions to heading capitalization are upgrades, corporations, and entities. Those should follow in-game styling and capitalization.
1. If a section of an article is empty or needs information filled in, the pull request should be created as a draft with a comment requesting the help needed.
1. Headings should never contain links.

### Linking

1. Two links should not be immediately back to back to avoid appearing as one link. Comma-separated lists are okay.
1. Links to other articles should not be excessively repeated. Only link to an article once per Heading section.

Expand Down Expand Up @@ -134,28 +143,30 @@ Generally not applicable. If there are spoiler concerns in documentation or guid
1. In cases where the vast majority of the content of a given page would be classified as spoilers, and hiding so much of the content would be impractical or otherwise undesirable, it is sufficient to include an overt message warning readers of the spoilers ahead instead of hiding them. This warning should exist either at the top of the page or immediately after a small introductory section that is itself free of spoilers.

### Adding Spoilers

1. Spoilers should be added by following the following example:

```html
<details>
<summary>Lorem Ipsum</summary>
Dolor icecream :)
</details>
```


### Dates

1. Dates should be written in ISO 8601 style, YYYY-MM-DD.
1. Avoid referring to seasons such as summer, instead use early, mid, late 2023.

### Commands

1. When quoting commands they should be formatted like the following: `xena.defender { bank: true, stuff: 123 }`

### Filenames

1. [Snakecase](https://en.wikipedia.org/wiki/Snake_case) should be used for filenames.

### Templates

1. Use existing templates.
1. If a template does not exist for what you want to make, propose a new one via a pull request.



0 comments on commit e2bb1e8

Please sign in to comment.