From 931d7e588a9ce5d2e905aa39a13747baa63f99e7 Mon Sep 17 00:00:00 2001 From: hydroflame <79246165+hydroflame@users.noreply.github.com> Date: Sun, 6 Aug 2023 00:05:03 -0400 Subject: [PATCH] Remove more rtd references (#702) --- README.md | 3 +-- doc/CONTRIBUTING.md | 7 ++---- .../doc/advanced/corporations.md | 3 +++ src/Documentation/doc/changelog.md | 8 +++---- src/GameOptions/ui/GameOptionsSidebar.tsx | 22 ++----------------- src/GameOptions/ui/RemoteAPIPage.tsx | 5 ++++- src/Literature/Literatures.ts | 4 ---- src/PersonObjects/Sleeve/ui/SleeveRoot.tsx | 6 ----- src/ScriptEditor/NetscriptDefinitions.d.ts | 5 ----- src/ScriptEditor/ui/Toolbar.tsx | 8 +------ src/StockMarket/ui/InfoAndPurchases.tsx | 9 ++------ 11 files changed, 18 insertions(+), 62 deletions(-) diff --git a/README.md b/README.md index fbe877a2f..97884d648 100644 --- a/README.md +++ b/README.md @@ -13,8 +13,7 @@ See the [frequently asked questions](./doc/FAQ.md) for more information . To dis # Documentation -The game's official documentation can be found on [Read The -Docs](http://bitburner-official.readthedocs.io/). Please note that this is still a work-in-progress. +The game's official documentation can be found in-game. The [in-game documentation](./markdown/bitburner.md) is generated from the [TypeScript definitions](./src/ScriptEditor/NetscriptDefinitions.d.ts). diff --git a/doc/CONTRIBUTING.md b/doc/CONTRIBUTING.md index b5aa2d7d2..8cb3e5d6e 100644 --- a/doc/CONTRIBUTING.md +++ b/doc/CONTRIBUTING.md @@ -213,9 +213,8 @@ the following rules: ## As a Documenter -To contribute to and view your changes to the BitBurner documentation on [Read The -Docs](http://bitburner.readthedocs.io/), you will -need to have Python installed, along with [Sphinx](http://www.sphinx-doc.org). +To contribute to and view your changes to the BitBurner documentation in-game, you will +need to edit the files in [this folder](https://github.com/bitburner-official/bitburner-src/tree/dev/src/Documentation/doc) To make change to the [in-game documentation](../markdown/bitburner.md), you will need to modify the [TypeScript definitions](../src/ScriptEditor/NetscriptDefinitions.d.ts), not the Markdown files. @@ -230,8 +229,6 @@ rules: - Rebase your branch if necessary. - When submitting the pull request, make sure that the base fork is _bitburner-official/bitburner-src_ and the base is _dev_. -- Do not check in any generated files under `doc\`. The documentation is built - automatically by ReadTheDocs. ## Deploying a new version diff --git a/src/Documentation/doc/advanced/corporations.md b/src/Documentation/doc/advanced/corporations.md index e69de29bb..d6c371747 100644 --- a/src/Documentation/doc/advanced/corporations.md +++ b/src/Documentation/doc/advanced/corporations.md @@ -0,0 +1,3 @@ +# Corporations + +PLACEHOLDER diff --git a/src/Documentation/doc/changelog.md b/src/Documentation/doc/changelog.md index 4a721f479..e6c76e8c4 100644 --- a/src/Documentation/doc/changelog.md +++ b/src/Documentation/doc/changelog.md @@ -284,7 +284,7 @@ GRAFTING: DOCUMENTATION - Many documentation updates (@Mughur, @d0sboots, @Snarling, @teauxfu). -- Official non-markdown docs are at http://bitburner-official.readthedocs.io/ +- Official non-markdown docs are at https://github.com/bitburner-official/bitburner-src/tree/dev/src/Documentation/doc - Official dev version markdown docs are at https://github.com/bitburner-official/bitburner-src/blob/dev/markdown/bitburner.ns.md - Official stable version markdown docs are at https://github.com/bitburner-official/bitburner-src/blob/stable/markdown/bitburner.ns.md - Dev version documentation is now kept up to date as changes are made. (@Snarling) @@ -1306,7 +1306,7 @@ Stanek Gift ** Announcement ** - Several API breaks have been implemented. -- See the v1.0.0 migration guide https://bitburner.readthedocs.io/en/latest/v1.0.0_migration.html +- See the v1.0.0 migration guide under Documentation - Everyone gets 10 free neuroflux level. ** Netscript ** @@ -2685,8 +2685,6 @@ Stanek Gift - Added a very rudimentary directory system to the Terminal - - Details here: https://bitburner.readthedocs.io/en/latest/basicgameplay/terminal.html#filesystem-directories - - Added numHashes(), hashCost(), and spendHashes() functions to the Netscript Hacknet Node API - 'Generate Coding Contract' hash upgrade is now more expensive - 'Generate Coding Contract' hash upgrade now generates the contract randomly on the server, rather than on home computer @@ -3180,7 +3178,7 @@ Stanek Gift ## v0.37.0 - 5/20/2018 -- NetscriptJS (Netscript 2.0) released (Documentation here: http://bitburner.readthedocs.io/en/latest/netscriptjs.html) +- NetscriptJS (Netscript 2.0) released - Running the game with the '?noScripts' query will start the game without loading any of your scripts. This should be used if you accidentally write a script that crashes your game ## v0.36.1 - 5/11/2018 diff --git a/src/GameOptions/ui/GameOptionsSidebar.tsx b/src/GameOptions/ui/GameOptionsSidebar.tsx index cf39d9939..19f604c6e 100644 --- a/src/GameOptions/ui/GameOptionsSidebar.tsx +++ b/src/GameOptions/ui/GameOptionsSidebar.tsx @@ -1,14 +1,4 @@ -import { - BugReport, - Chat, - Download, - LibraryBooks, - Palette, - Reddit, - Save, - SystemUpdateAlt, - Upload, -} from "@mui/icons-material"; +import { BugReport, Chat, Download, LibraryBooks, Palette, Reddit, Save, Upload } from "@mui/icons-material"; import { Box, Button, List, ListItemButton, Paper, Tooltip, Typography } from "@mui/material"; import { default as React, useRef, useState } from "react"; import { FileDiagnosticModal } from "../../Diagnostic/FileDiagnosticModal"; @@ -239,7 +229,7 @@ export const GameOptionsSidebar = (props: IProps): React.ReactElement => { sx={{ gridArea: "links", display: "grid", - gridTemplateAreas: `"bug changelog" + gridTemplateAreas: `"bug bug" "discord reddit" "tut tut" "plaza plaza"`, @@ -255,14 +245,6 @@ export const GameOptionsSidebar = (props: IProps): React.ReactElement => { > Report Bug - diff --git a/src/GameOptions/ui/RemoteAPIPage.tsx b/src/GameOptions/ui/RemoteAPIPage.tsx index b870ef807..4c4015334 100644 --- a/src/GameOptions/ui/RemoteAPIPage.tsx +++ b/src/GameOptions/ui/RemoteAPIPage.tsx @@ -20,7 +20,10 @@ export const RemoteAPIPage = (): React.ReactElement => { text editor and then upload files to the home server. - + Documentation diff --git a/src/Literature/Literatures.ts b/src/Literature/Literatures.ts index e52eac351..17505e447 100644 --- a/src/Literature/Literatures.ts +++ b/src/Literature/Literatures.ts @@ -6,10 +6,6 @@ export const Literatures: Record = { title: "The Beginner's Guide to Hacking", filename: LiteratureName.HackersStartingHandbook, text: - "Some resources:

" + - "Learn to Program

" + - "For Experienced JavaScript Developers: NetscriptJS

" + - "Netscript Documentation

" + "When starting out, hacking is the most profitable way to earn money and progress. This " + "is a brief collection of tips/pointers on how to make the most out of your hacking scripts.

" + "-hack() and grow() both work by percentages. hack() steals a certain percentage of the " + diff --git a/src/PersonObjects/Sleeve/ui/SleeveRoot.tsx b/src/PersonObjects/Sleeve/ui/SleeveRoot.tsx index dc13aa0df..eb924391c 100644 --- a/src/PersonObjects/Sleeve/ui/SleeveRoot.tsx +++ b/src/PersonObjects/Sleeve/ui/SleeveRoot.tsx @@ -28,12 +28,6 @@ export function SleeveRoot(): React.ReactElement { - {Player.sleeves.map((sleeve, i) => ( diff --git a/src/ScriptEditor/NetscriptDefinitions.d.ts b/src/ScriptEditor/NetscriptDefinitions.d.ts index 6d44d037c..42b5f587e 100644 --- a/src/ScriptEditor/NetscriptDefinitions.d.ts +++ b/src/ScriptEditor/NetscriptDefinitions.d.ts @@ -4553,10 +4553,6 @@ interface UserInterface { * await ns.hack('n00dles'); * } * ``` - * {@link https://bitburner-official.readthedocs.io/en/latest/netscript/netscriptjs.html| ns2 in-game docs} - *
- * For (deprecated) .script usage, see: {@link https://bitburner-official.readthedocs.io/en/latest/netscript/netscript1.html| ns1 in-game docs} - *
*/ export interface NS { /** @@ -6134,7 +6130,6 @@ export interface NS { * * WARNING: Port Handles only work in NetscriptJS (Netscript 2.0). They will not work in Netscript 1.0. * - * @see https://bitburner-official.readthedocs.io/en/latest/netscript/netscriptmisc.html#netscript-ports * @param portNumber - Port number. Must be an integer between 1 and 20. */ getPortHandle(portNumber: number): NetscriptPort; diff --git a/src/ScriptEditor/ui/Toolbar.tsx b/src/ScriptEditor/ui/Toolbar.tsx index bd1f9c553..2e7270426 100644 --- a/src/ScriptEditor/ui/Toolbar.tsx +++ b/src/ScriptEditor/ui/Toolbar.tsx @@ -69,17 +69,11 @@ export function Toolbar({ editor, onSave }: IProps) { Terminal (Ctrl/Cmd + b) - {" "} - Documentation:{" "} - - Basic - - {" | "} - Full + Documentation diff --git a/src/StockMarket/ui/InfoAndPurchases.tsx b/src/StockMarket/ui/InfoAndPurchases.tsx index ff64515b1..39a3c8301 100644 --- a/src/StockMarket/ui/InfoAndPurchases.tsx +++ b/src/StockMarket/ui/InfoAndPurchases.tsx @@ -13,7 +13,6 @@ import { Money } from "../../ui/React/Money"; import { initStockMarket } from "../StockMarket"; import Typography from "@mui/material/Typography"; -import Link from "@mui/material/Link"; import Button from "@mui/material/Button"; import Tooltip from "@mui/material/Tooltip"; import IconButton from "@mui/material/IconButton"; @@ -171,14 +170,10 @@ function Purchase4SMarketDataButton(props: IProps): React.ReactElement { export function InfoAndPurchases(props: IProps): React.ReactElement { const [helpOpen, setHelpOpen] = useState(false); - const documentationLink = "https://bitburner-official.readthedocs.io/en/latest/basicgameplay/stockmarket.html"; return ( <> - Welcome to the World Stock Exchange (WSE)! - - Investopedia - -
+ Welcome to the World Stock Exchange (WSE)! +