doc changes

This commit is contained in:
Olivier Gagnon 2021-11-02 14:32:54 -04:00
parent 215932c59c
commit a81a9af1c7
6 changed files with 30 additions and 21947 deletions

@ -109,7 +109,7 @@
/** /**
* (REQUIRED) Whether to generate an API report. * (REQUIRED) Whether to generate an API report.
*/ */
"enabled": true "enabled": true,
/** /**
* The filename for the API report files. It will be combined with "reportFolder" or "reportTempFolder" to produce * The filename for the API report files. It will be combined with "reportFolder" or "reportTempFolder" to produce
@ -120,7 +120,7 @@
* SUPPORTED TOKENS: <packageName>, <unscopedPackageName> * SUPPORTED TOKENS: <packageName>, <unscopedPackageName>
* DEFAULT VALUE: "<unscopedPackageName>.api.md" * DEFAULT VALUE: "<unscopedPackageName>.api.md"
*/ */
// "reportFileName": "<unscopedPackageName>.api.md", // "reportFileName": "markdown/bitburner.api.md"
/** /**
* Specifies the folder where the API report file is written. The file name portion is determined by * Specifies the folder where the API report file is written. The file name portion is determined by
@ -135,7 +135,7 @@
* SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName> * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
* DEFAULT VALUE: "<projectFolder>/etc/" * DEFAULT VALUE: "<projectFolder>/etc/"
*/ */
// "reportFolder": "<projectFolder>/etc/", "reportFolder": "markdown"
/** /**
* Specifies the folder where the temporary report file is written. The file name portion is determined by * Specifies the folder where the temporary report file is written. The file name portion is determined by
@ -160,7 +160,7 @@
/** /**
* (REQUIRED) Whether to generate a doc model file. * (REQUIRED) Whether to generate a doc model file.
*/ */
"enabled": true "enabled": true,
/** /**
* The output path for the doc model file. The file extension should be ".api.json". * The output path for the doc model file. The file extension should be ".api.json".
@ -171,7 +171,7 @@
* SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName> * SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
* DEFAULT VALUE: "<projectFolder>/temp/<unscopedPackageName>.api.json" * DEFAULT VALUE: "<projectFolder>/temp/<unscopedPackageName>.api.json"
*/ */
// "apiJsonFilePath": "<projectFolder>/temp/<unscopedPackageName>.api.json" "apiJsonFilePath": "input/bitburner.api.json"
}, },
/** /**

@ -2,8 +2,8 @@
# #
# You can set these variables from the command line. # You can set these variables from the command line.
SPHINXOPTS = SPHINXOPTS = -W
SPHINXBUILD = python -msphinx SPHINXBUILD = python2.7 -msphinx
SOURCEDIR = source SOURCEDIR = source
BUILDDIR = build BUILDDIR = build

@ -4,7 +4,7 @@ Changelog
========= =========
v0.58.0 - 2021-10-27 Road to Steam (hydroflame & community) v0.58.0 - 2021-10-27 Road to Steam (hydroflame & community)
------------------------------------------- -----------------------------------------------------------
** Announcement ** ** Announcement **
@ -63,7 +63,7 @@ v0.58.0 - 2021-10-27 Road to Steam (hydroflame & community)
* nerf noodle bar * nerf noodle bar
v0.57.0 - 2021-10-16 It was too cheap! (hydroflame & community) v0.57.0 - 2021-10-16 It was too cheap! (hydroflame & community)
------------------------------------------- ---------------------------------------------------------------
** BREAKING (kindof) ** ** BREAKING (kindof) **
@ -114,7 +114,7 @@ v0.57.0 - 2021-10-16 It was too cheap! (hydroflame & community)
* nerf noodle bar * nerf noodle bar
v0.56.0 - 2021-10-11 Trimming the backlog (hydroflame & community) v0.56.0 - 2021-10-11 Trimming the backlog (hydroflame & community)
------------------------------------------- ------------------------------------------------------------------
** BREAKING ** ** BREAKING **
@ -217,7 +217,7 @@ v0.56.0 - 2021-10-11 Trimming the backlog (hydroflame & community)
* nerf noodle bar * nerf noodle bar
v0.55.0 - 2021-09-20 Material UI (hydroflame & community) v0.55.0 - 2021-09-20 Material UI (hydroflame & community)
------------------------------------------- ---------------------------------------------------------
** Global ** ** Global **
@ -239,7 +239,7 @@ v0.55.0 - 2021-09-20 Material UI (hydroflame & community)
* nerf noodle bar * nerf noodle bar
v0.54.0 - 2021-09-20 One big react node (hydroflame & community) v0.54.0 - 2021-09-20 One big react node (hydroflame & community)
------------------------------------------- ----------------------------------------------------------------
** UI ** ** UI **
@ -283,7 +283,7 @@ v0.54.0 - 2021-09-20 One big react node (hydroflame & community)
* nerf noodle bar * nerf noodle bar
v0.53.0 - 2021-09-09 Way too many things. (hydroflame & community) v0.53.0 - 2021-09-09 Way too many things. (hydroflame & community)
------------------------------------------- ------------------------------------------------------------------
** Dev? ** ** Dev? **
@ -362,7 +362,7 @@ v0.53.0 - 2021-09-09 Way too many things. (hydroflame & community)
* nerf noodle bar * nerf noodle bar
v0.52.9 - 2021-08-27 Less lag! (hydroflame & community) v0.52.9 - 2021-08-27 Less lag! (hydroflame & community)
------------------------------------------- -------------------------------------------------------
** Active Scripts page ** ** Active Scripts page **
@ -393,7 +393,7 @@ v0.52.9 - 2021-08-27 Less lag! (hydroflame & community)
* nerf noodle bar * nerf noodle bar
v0.52.8 - 2021-08-23 Fixing the previous patch tbh ROUND 2 (hydroflame) v0.52.8 - 2021-08-23 Fixing the previous patch tbh ROUND 2 (hydroflame)
------------------------------------------- -----------------------------------------------------------------------
** Script editor ** ** Script editor **
@ -413,7 +413,7 @@ v0.52.8 - 2021-08-23 Fixing the previous patch tbh ROUND 2 (hydroflame)
* nerf noodle bar * nerf noodle bar
v0.52.7 - 2021-08-21 Fixing the previous patch tbh (hydroflame) v0.52.7 - 2021-08-21 Fixing the previous patch tbh (hydroflame)
------------------------------------------- ---------------------------------------------------------------
** Netscript ** ** Netscript **
@ -441,7 +441,7 @@ v0.52.7 - 2021-08-21 Fixing the previous patch tbh (hydroflame)
* nerf noodle bar * nerf noodle bar
v0.52.6 - 2021-08-21 Logboxes and VS-code (hydroflame) v0.52.6 - 2021-08-21 Logboxes and VS-code (hydroflame)
------------------------------------------- ------------------------------------------------------
** Text Editor ** ** Text Editor **
@ -463,7 +463,7 @@ v0.52.6 - 2021-08-21 Logboxes and VS-code (hydroflame)
* nerf noodle bar * nerf noodle bar
v0.52.5 - 2021-08-19 CPU cores are useful!? (hydroflame) v0.52.5 - 2021-08-19 CPU cores are useful!? (hydroflame)
------------------------------------------- --------------------------------------------------------
** Terminal ** ** Terminal **
@ -489,7 +489,7 @@ v0.52.5 - 2021-08-19 CPU cores are useful!? (hydroflame)
* nerf noodle bar * nerf noodle bar
v0.52.4 - 2021-08-19 Bladeburner in React (hydroflame) v0.52.4 - 2021-08-19 Bladeburner in React (hydroflame)
------------------------------------------- ------------------------------------------------------
** Bladeburner ** ** Bladeburner **
@ -511,7 +511,7 @@ v0.52.4 - 2021-08-19 Bladeburner in React (hydroflame)
* nerf noodle bar * nerf noodle bar
v0.52.3 - 2021-08-15 Gangs were OP (hydroflame) v0.52.3 - 2021-08-15 Gangs were OP (hydroflame)
------------------------------------------- -----------------------------------------------
** Gang ** ** Gang **
@ -534,7 +534,7 @@ v0.52.3 - 2021-08-15 Gangs were OP (hydroflame)
* nerf noodle bar * nerf noodle bar
v0.52.2 - 2021-08-15 Oh yeah, BN11 is a thing (drunk hydroflame tbh) v0.52.2 - 2021-08-15 Oh yeah, BN11 is a thing (drunk hydroflame tbh)
------------------------------------------- --------------------------------------------------------------------
** Source-Files ** ** Source-Files **
@ -552,7 +552,7 @@ v0.52.2 - 2021-08-15 Oh yeah, BN11 is a thing (drunk hydroflame tbh)
* nerf noodle bar * nerf noodle bar
v0.52.1 - 2021-08-10 bugfixing (hydroflame & community) v0.52.1 - 2021-08-10 bugfixing (hydroflame & community)
------------------------------------------- -------------------------------------------------------
** Misc. ** ** Misc. **
@ -560,11 +560,9 @@ v0.52.1 - 2021-08-10 bugfixing (hydroflame & community)
* Fix typo in corporation Market Data. * Fix typo in corporation Market Data.
* Fix typo in docs for hackPercent. * Fix typo in docs for hackPercent.
* The tutorial encourages the players to connect to home before creating `n00dles.script` * The tutorial encourages the players to connect to home before creating `n00dles.script`
* The dark web `buy` command now accepts `-1` (one) and `--list` instead of just * The dark web `buy` command now accepts `-1` (one) and `--list` instead of just `-l`. Helps some confused players.
`-l`. Helps some confused players.
* Character overview screen no longer hidden on the corporation screen. * Character overview screen no longer hidden on the corporation screen.
* Infiltration difficulty display is now more explicit (It's a big arrow instead * Infiltration difficulty display is now more explicit (It's a big arrow instead of just one word.)
of just one word.)
* Fix wrong ram value in tutorial. (@MageKing17) * Fix wrong ram value in tutorial. (@MageKing17)
* Plenty of augmentation description cleanup (@Kwazygloo) * Plenty of augmentation description cleanup (@Kwazygloo)
* Plenty of typo/description fixed (@MageKing17) * Plenty of typo/description fixed (@MageKing17)
@ -667,7 +665,7 @@ v0.51.10 - 2021-05-31 Focus Mark, Focus! (hydroflame)
* nerf noodle bar * nerf noodle bar
v0.51.9 - 2021-05-17 offline progress and exports! (hydroflame & community) v0.51.9 - 2021-05-17 offline progress and exports! (hydroflame & community)
--------------------------------------------------------------- ---------------------------------------------------------------------------
**Alias** **Alias**
@ -722,7 +720,7 @@ v0.51.9 - 2021-05-17 offline progress and exports! (hydroflame & community)
v0.51.8 - 2021-05-07 It was there all along (hydroflame & community) v0.51.8 - 2021-05-07 It was there all along (hydroflame & community)
-------------------------------------------------------- --------------------------------------------------------------------
**Servers** **Servers**
@ -779,7 +777,7 @@ v0.51.8 - 2021-05-07 It was there all along (hydroflame & community)
* nerf noodle bar * nerf noodle bar
v0.51.7 - 2021-04-28 n00dles (hydroflame & community) v0.51.7 - 2021-04-28 n00dles (hydroflame & community)
----------------------------------------- -----------------------------------------------------
**Tutorial servers** **Tutorial servers**
@ -838,7 +836,7 @@ v0.51.7 - 2021-04-28 n00dles (hydroflame & community)
v0.51.6 - 2021-04-28 Backdoor! (hydroflame & community) v0.51.6 - 2021-04-28 Backdoor! (hydroflame & community)
------------------------------------------ -------------------------------------------------------
**Backdoor** **Backdoor**

@ -94,7 +94,7 @@
"cy:dev": "start-server-and-test start:dev http://localhost:8000 cy:open", "cy:dev": "start-server-and-test start:dev http://localhost:8000 cy:open",
"cy:open": "cypress open", "cy:open": "cypress open",
"cy:run": "cypress run", "cy:run": "cypress run",
"doc": "npx api-extractor run; cp temp/bitburner.api.json input/; cp temp/bitburner.api.md markdown/; npx api-documenter markdown;", "doc": "npx api-extractor run && npx api-documenter markdown",
"format": "prettier --write .", "format": "prettier --write .",
"start": "http-server -p 8000", "start": "http-server -p 8000",
"start:dev": "webpack-dev-server --progress --env.devServer --mode development", "start:dev": "webpack-dev-server --progress --env.devServer --mode development",

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff