-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Literally just the entirety of /tg/ with no changes here
- Loading branch information
Showing
8,554 changed files
with
2,622,651 additions
and
1 deletion.
The diff you're trying to view is too large. We only load the first 3000 changed files.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,27 @@ | ||
.dockerignore | ||
.editorconfig | ||
GPLv3.txt | ||
LICENSE | ||
README.md | ||
TGS3.json | ||
.github | ||
.gitignore | ||
.gitattributes | ||
.git/hooks | ||
.git/info | ||
.git/modules | ||
.git/objects | ||
.git/refs | ||
.vs* | ||
cfg | ||
data | ||
SQL | ||
node_modules | ||
tgstation.dmb | ||
tgstation.int | ||
tgstation.rsc | ||
tgstation.lk | ||
tgstation.dyn.rsc | ||
*.dll | ||
Dockerfile | ||
tools/bootstrap/.cache |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,20 @@ | ||
[*] | ||
indent_style = tab | ||
indent_size = 4 | ||
charset = utf-8 | ||
trim_trailing_whitespace = true | ||
insert_final_newline = true | ||
end_of_line = lf | ||
|
||
[*.yml] | ||
indent_style = space | ||
indent_size = 2 | ||
|
||
[*.py] | ||
indent_style = space | ||
|
||
[*.md] | ||
trim_trailing_whitespace = false | ||
|
||
[Dockerfile] | ||
indent_style = space |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,14 @@ | ||
#Ignores big formatting commits when checking blame. | ||
#To make use of this file by default, run 'git config blame.ignoreRevsFile .git-blame-ignore-revs' | ||
#in the project folder | ||
|
||
## Line ending conversions | ||
|
||
# Force LF line endings with gitattributes and convert repo | ||
62676e72a85cd23e7a87d94adff96d17859dbdc5 | ||
# Line ending apocalypse | ||
134a76cc8f5517bdc1bba5a8cbe01dc820df1c2a | ||
# Initial pass to convert LF to CRLF | ||
8af8a43d6f27e342e79d4aacb22b7668cbdc8559 | ||
# Many changes | ||
931da9e7ef8c0f52a768eed7998e7e62ccdefcdc |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,46 @@ | ||
# Auto detect text files and perform LF normalization | ||
* text=auto | ||
|
||
## Enforce text mode and LF line breaks | ||
*.bat text eol=lf | ||
*.css text eol=lf | ||
*.css text eol=lf | ||
*.dm text eol=lf | ||
*.dme text eol=lf | ||
*.dmf text eol=lf | ||
*.htm text eol=lf | ||
*.html text eol=lf | ||
*.html text eol=lf | ||
*.js text eol=lf | ||
*.json text eol=lf | ||
*.jsx text eol=lf | ||
*.md text eol=lf | ||
*.py text eol=lf | ||
*.scss text eol=lf | ||
*.sh text eol=lf | ||
*.sql text eol=lf | ||
*.svg text eol=lf | ||
*.ts text eol=lf | ||
*.tsx text eol=lf | ||
*.txt text eol=lf | ||
*.yaml text eol=lf | ||
*.yml text eol=lf | ||
|
||
## Enforce binary mode | ||
*.bmp binary | ||
*.dll binary | ||
*.dmb binary | ||
*.exe binary | ||
*.gif binary | ||
*.jpg binary | ||
*.png binary | ||
*.so binary | ||
|
||
## Merger hooks, run tools/hooks/install.bat or install.sh to set up | ||
*.dmm text eol=lf merge=dmm | ||
*.dmi binary merge=dmi | ||
|
||
##Force tab indents on dm files | ||
*.dm whitespace=indent-with-non-tab | ||
|
||
## Force changelog merging to use union | ||
html/changelog.html text eol=lf merge=union |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,108 @@ | ||
# dmdoc | ||
[DOCUMENTATION]: http://codedocs.tgstation13.org | ||
|
||
[BYOND]: https://secure.byond.com/ | ||
|
||
[DMDOC]: https://github.com/SpaceManiac/SpacemanDMM/tree/master/src/dmdoc | ||
|
||
[DMDOC] is a documentation generator for DreamMaker, the scripting language | ||
of the [BYOND] game engine. It produces simple static HTML files based on | ||
documented files, macros, types, procs, and vars. | ||
|
||
We use **dmdoc** to generate [DOCUMENTATION] for our code, and that documentation | ||
is automatically generated and built on every new commit to the master branch | ||
|
||
This gives new developers a clickable reference [DOCUMENTATION] they can browse to better help | ||
gain understanding of the /tg/station codebase structure and api reference. | ||
|
||
## Documenting code on /tg/station | ||
We use block comments to document procs and classes, and we use `///` line comments | ||
when documenting individual variables. | ||
|
||
It is required that all new code be covered with DMdoc code, according to the [Requirements](#Required) | ||
|
||
We also require that when you touch older code, you must document the functions that you | ||
have touched in the process of updating that code | ||
|
||
### Required | ||
A class *must* always be autodocumented, and all public functions *must* be documented | ||
|
||
All class level defined variables *must* be documented | ||
|
||
Internal functions *should* be documented, but may not be | ||
|
||
A public function is any function that a developer might reasonably call while using | ||
or interacting with your object. Internal functions are helper functions that your | ||
public functions rely on to implement logic | ||
|
||
|
||
### Documenting a proc | ||
When documenting a proc, we give a short one line description (as this is shown | ||
next to the proc definition in the list of all procs for a type or global | ||
namespace), then a longer paragraph which will be shown when the user clicks on | ||
the proc to jump to it's definition | ||
``` | ||
/** | ||
* Short description of the proc | ||
* | ||
* Longer detailed paragraph about the proc | ||
* including any relevant detail | ||
* Arguments: | ||
* * arg1 - Relevance of this argument | ||
* * arg2 - Relevance of this argument | ||
*/ | ||
``` | ||
|
||
### Documenting a class | ||
We first give the name of the class as a header, this can be omitted if the name is | ||
just going to be the typepath of the class, as dmdoc uses that by default | ||
|
||
Then we give a short oneline description of the class | ||
|
||
Finally we give a longer multi paragraph description of the class and it's details | ||
``` | ||
/** | ||
* # Classname (Can be omitted if it's just going to be the typepath) | ||
* | ||
* The short overview | ||
* | ||
* A longer | ||
* paragraph of functionality about the class | ||
* including any assumptions/special cases | ||
* | ||
*/ | ||
``` | ||
|
||
### Documenting a variable/define | ||
Give a short explanation of what the variable, in the context of the class, or define is. | ||
``` | ||
/// Type path of item to go in suit slot | ||
var/suit = null | ||
``` | ||
|
||
## Module level description of code | ||
Modules are the best way to describe the structure/intent of a package of code | ||
where you don't want to be tied to the formal layout of the class structure. | ||
|
||
On /tg/station we do this by adding markdown files inside the `code` directory | ||
that will also be rendered and added to the modules tree. The structure for | ||
these is deliberately not defined, so you can be as freeform and as wheeling as | ||
you would like. | ||
|
||
[Here is a representative example of what you might write](http://codedocs.tgstation13.org/code/modules/keybindings/readme.html) | ||
|
||
## Special variables | ||
You can use certain special template variables in DM DOC comments and they will be expanded | ||
``` | ||
[DEFINE_NAME] - Expands to a link to the define definition if documented | ||
[/mob] - Expands to a link to the docs for the /mob class | ||
[/mob/proc/Dizzy] - Expands to a link that will take you to the /mob class and anchor you to the dizzy proc docs | ||
[/mob/var/stat] - Expands to a link that will take you to the /mob class and anchor you to the stat var docs | ||
``` | ||
|
||
You can customise the link name by using `[link name][link shorthand].` | ||
|
||
eg. `[see more about dizzy here] [/mob/proc/Dizzy]` | ||
|
||
This is very useful to quickly link to other parts of the autodoc code to expand | ||
upon a comment made, or reasoning about code |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,89 @@ | ||
# This list auto requests reviews from the specified org members | ||
# when a PR that modifies the file in question is opened | ||
# This list is alphabetized by User -> Filename KEEP IT THAT WAY | ||
# In the event that multiple org members are to be informed of changes | ||
# to the same file or dir, add them to the end under Multiple Owners | ||
|
||
# Cobby | ||
/code/modules/reagents/ @ExcessiveUseOfCobblestone | ||
/code/modules/research/designs/medical_designs.dm @ExcessiveUseOfCobblestone | ||
/code/modules/surgery/ @ExcessiveUseOfCobblestone | ||
/code/game/objects/items/storage/firstaid.dm @ExcessiveUseOfCobblestone | ||
/code/modules/jobs/job_types/chief_medical_officer.dm @ExcessiveUseOfCobblestone | ||
/code/modules/jobs/job_types/medical_doctor.dm @ExcessiveUseOfCobblestone | ||
|
||
# Cyberboss | ||
|
||
/code/__HELPERS/jatum.dm @Cyberboss | ||
/code/controllers/subsystem/atoms.dm @Cyberboss | ||
/code/controllers/subsystem/mapping.dm @Cyberboss | ||
/code/controllers/globals.dm @Cyberboss | ||
/code/datums/helper_datums/getrev.dm @Cyberboss | ||
/code/datums/map_config.dm @Cyberboss | ||
/code/datums/forced_movement.dm @Cyberboss | ||
/code/datums/holocall.dm @Cyberboss | ||
/code/modules/admin/verbs/adminhelp.dm @Cyberboss | ||
/code/modules/admin/verbs/adminpm.dm @Cyberboss | ||
/code/modules/mapping/ @Cyberboss | ||
/tools/LinuxOneShot/ @Cyberboss | ||
/tools/tgs4_scripts/ @Cyberboss | ||
|
||
# Jared-Fogle | ||
|
||
/code/modules/unit_tests/ @Jared-Fogle | ||
|
||
# Jordie0608 | ||
|
||
/SQL/ @Jordie0608 | ||
/code/controllers/subsystem/dbcore.dm @Jordie0608 | ||
/tools/SQLAlertEmail/ @Jordie0608 | ||
|
||
# LemonInTheDark | ||
|
||
/code/__DEFINES/atmospherics.dm @LemonInTheDark | ||
/code/modules/atmospherics/ @LemonInTheDark | ||
|
||
# MrStonedOne | ||
|
||
/SQL/database_changelog.txt @MrStonedOne | ||
/code/__DEFINES/MC.dm @MrStonedOne | ||
/code/controllers/admin.dm @MrStonedOne | ||
/code/controllers/master.dm @MrStonedOne | ||
/code/controllers/failsafe.dm @MrStonedOne | ||
/code/controllers/subsystem.dm @MrStonedOne | ||
/code/controllers/subsystem/timer.dm @MrStonedOne | ||
/code/controllers/configuration/entries @MrStonedOne | ||
/config/ @MrStonedOne | ||
|
||
# ninjanomnom | ||
|
||
/code/__DEFINES/dcs/ @ninjanomnom | ||
/code/controllers/subsystem/dcs.dm @ninjanomnom | ||
/code/controllers/subsystem/shuttle.dm @ninjanomnom | ||
/code/datums/components/ @ninjanomnom | ||
/code/datums/elements/ @ninjanomnom | ||
/code/modules/shuttle/ @ninjanomnom | ||
|
||
# ShizCalev | ||
|
||
/sound/ @ShizCalev | ||
|
||
# stylemistake | ||
|
||
/code/__DEFINES/chat.dm @stylemistake | ||
/code/__DEFINES/tgui.dm @stylemistake | ||
/code/controllers/subsystem/chat.dm @stylemistake | ||
/code/controllers/subsystem/tgui.dm @stylemistake | ||
/code/modules/tgchat @stylemistake | ||
/code/modules/tgui @stylemistake | ||
/code/modules/tgui_panel @stylemistake | ||
/tgui @stylemistake | ||
|
||
# Multiple Owners | ||
|
||
/icons/ @Twaticus @ShizCalev | ||
/code/controllers/subsystem/air.dm @LemonInTheDark @MrStonedOne | ||
/_maps/ @EOBGames @ShizCalev | ||
|
||
#SIC SEMPER TYRANNIS | ||
/code/modules/hydroponics/grown/citrus.dm @optimumtact |
Oops, something went wrong.