Skip to content

Commit 4e0649f

Browse files
Add How you can help page WIP
1 parent 2747d4e commit 4e0649f

File tree

4 files changed

+95
-17
lines changed

4 files changed

+95
-17
lines changed

web/astro.config.mjs

Lines changed: 3 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -3,15 +3,9 @@ import { defineConfig } from 'astro/config';
33
import starlight from '@astrojs/starlight';
44
import mtasaStarlightThemePlugin from '@multitheftauto/starlight-theme-mtasa';
55
import { SITE_TITLE, SITE_URL } from './src/content.constants';
6-
import fs from 'fs';
7-
import path from 'path';
86

97
export default defineConfig({
108
site: SITE_URL,
11-
redirects: {
12-
// External redirects only, the others are handled by CloudFlare pages (_redirects file)
13-
"/How_you_can_help": "https://github.com/multitheftauto/wiki.multitheftauto.com/blob/main/CONTRIBUTING.md",
14-
},
159
i18n: {
1610
locales: ["en", "es", "fr"],
1711
defaultLocale: "en",
@@ -44,17 +38,12 @@ export default defineConfig({
4438
sidebar: [
4539
{
4640
label: 'Start here',
47-
translations: {
48-
es: 'Empeza aquí',
49-
fr: 'Commence ici',
50-
},
5141
items: [
5242
{
5343
label: 'Introduction', link: '/',
54-
translations: {
55-
es: 'Introducción',
56-
fr: 'Introduction',
57-
},
44+
},
45+
{
46+
label: 'How you can help', link: '/How_you_can_help',
5847
},
5948
]
6049
},

web/src/pages/How_you_can_help.astro

Lines changed: 90 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,90 @@
1+
---
2+
import StarlightPage from '@astrojs/starlight/components/StarlightPage.astro';
3+
// import { getSeeAlsoLinksFromList } from '@src/utils/general';
4+
// import SeeAlsoSection from '@src/components/SeeAlsoSection.astro';
5+
import { MTA_CURRENT_VERSION } from '@src/content.constants';
6+
---
7+
8+
<StarlightPage frontmatter={{
9+
template: 'doc',
10+
title: 'How you can help',
11+
tableOfContents: false,
12+
}}>
13+
<p><strong>Multi Theft Auto</strong> has loads of areas in which you can help. In turn, we'll be more than happy to help you get started with any ideas you have, help test them and - if they're good enough - release them to the whole community. This page outlines the key areas you could do something in, of course, there are many things we've not thought of, so think outside the box!</p>
14+
15+
<h3>Programming</h3>
16+
<ul>
17+
<li>Become a patch contributor by sending <a href="https://github.com/multitheftauto/mtasa-blue/pulls">pull requests</a> to MTA, containing requested features or bugfixes: <a href="/Coding_guidelines">Coding guidelines</a></li>
18+
</ul>
19+
20+
<h3>Translating</h3>
21+
<ul>
22+
<li>Translate MTA to your native language on Crowdin at <a href="https://multitheftauto.crowdin.com/">https://multitheftauto.crowdin.com/</a></li>
23+
</ul>
24+
25+
<h3>Scripting</h3>
26+
<ul>
27+
<li>Become a contributor to MTA's official resources, read more about them here: <a href="/Default_resources">Default resources</a></li>
28+
<li>Create and <a href="https://community.multitheftauto.com/">publish</a> a gamemode or useful script
29+
<ul>
30+
<li><a href="/Scripting_Introduction">Scripting Introduction</a></li>
31+
<li><a href="https://www.lua.org/pil/index.html">"Programming in Lua" Manual</a></li>
32+
</ul>
33+
</li>
34+
<li>Make a general purpose resource that provides useful functions to other resources.</li>
35+
</ul>
36+
37+
<h3>Mapping</h3>
38+
<ul>
39+
<li>Create and <a href="https://community.multitheftauto.com/">publish</a> a map for an existing gamemode, with the map editor.
40+
<ul>
41+
<li><a href="/Resource:Editor">Map Editor Manual</a></li>
42+
</ul>
43+
</li>
44+
</ul>
45+
46+
<h3>Web development</h3>
47+
<ul>
48+
<li>Create your own system for statistics - using the <a href="/PHP_SDK">PHP SDK</a> as a basis. Join the
49+
<a href="https://discord.com/invite/mtasa">MTA Discord</a> (or
50+
<a href="https://discord.gg/GNN6PRtTnu">development Discord</a>) for help.
51+
</li>
52+
</ul>
53+
54+
<h3>Documentation</h3>
55+
<p>Before you make changes check out: <a href="/Help:Editing_Guidelines">Editing Guidelines</a> and
56+
<a href="/Help:MTA_Wiki_Specific_Templates">Specific Templates</a></p>
57+
<ul>
58+
<li>Finish documentation for <a href="/Category:Incomplete">Incomplete functions</a> - ask in #mta.scripting if you're not sure of something.</li>
59+
<li>Add examples to <a href="/Category:Needs_Example">functions & events missing examples</a> - please <strong>test</strong> them, and again, ask if you need help.</li>
60+
<li>Review and verify <a href="/Category:Needs_Checking">pages that need checking</a> - make sure highlighted issues are solved before removing pages from the category.</li>
61+
<li>Expand the pages that explain <a href="/Category:Scripting_Concepts">MTA core concepts</a>.</li>
62+
<li>Write <a href="https://forum.multitheftauto.com/forum/123-tutorials/">tutorials</a> to help new people.</li>
63+
<li>Translate the wiki pages so people from other countries can get started in MTA too.</li>
64+
<li>Create documentation for undocumented functions and events <a href="/Undocumented_Items">Undocumented Items</a></li>
65+
<li>Keep 'changes in' <a href={"/Changes_in_"+MTA_CURRENT_VERSION.full}>current work-in-progress</a> for future releases updated.</li>
66+
</ul>
67+
68+
<h3>Quality Assurance</h3>
69+
<ul>
70+
<li><a href="https://github.com/multitheftauto/mtasa-blue/issues">Report issues</a> with the mod, make sure to do a search on the already reported issues first.</li>
71+
<li>Test and confirm existing reported issues.</li>
72+
<li>Use the newest build of MTA to detect and report new bugs, by going to 'Settings', 'Advanced', 'Update build type' and choosing 'Nightly' or get it regularly
73+
<a href="https://nightly.multitheftauto.com/">from here</a>.
74+
</li>
75+
<li>Any bugs which are related to a scripting function/event and present in the main release (rather than nightlies), document that bug by adding a
76+
<a href="/Help:MTA_Wiki_Specific_Templates">warning</a> to the wiki page to save other scripters a lot of time.
77+
</li>
78+
</ul>
79+
80+
<h3>Specific tasks</h3>
81+
<ul>
82+
<li>Create a fuzzer to check for crashes in our scripting functions.</li>
83+
</ul>
84+
85+
<h3>Grant</h3>
86+
<ul>
87+
<li>You can donate to MTA <a href="https://multitheftauto.com/donate/manage.php">here</a></li>
88+
</ul>
89+
90+
</StarlightPage>

web/src/pages/Lua_API.mdx

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,4 @@
11
import StarlightPage from '@astrojs/starlight/components/StarlightPage.astro';
2-
import AnchorHeading from '@astrojs/starlight/components/AnchorHeading.astro';
32
import { getSeeAlsoLinksFromList } from '@src/utils/general';
43
import SeeAlsoSection from '@src/components/SeeAlsoSection.astro';
54

web/src/pages/index.astro

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ import { Icon } from '@astrojs/starlight/components';
2828
<div class="mtahero_right">
2929
<p>Welcome to the <strong>new Multi Theft Auto Wiki</strong> (work in progress). Visit this wiki's <a href="https://github.com/multitheftauto/wiki.multitheftauto.com" target="_blank">GitHub repository</a> for more information about the project and how to contribute. The old wiki is still active at <a href="https://wiki.multitheftauto.com/wiki/Main_Page">wiki.multitheftauto.com</a> (where unofficial articles and pages are still available).</p>
3030

31-
<p>There are many <a href="/How_you_can_help" target="_blank">things you can do</a> to help us improve MTA - create a map, a gamemode, help document scripting functions, write example code, write tutorials or just play MTA and report the bugs you find.</p>
31+
<p>There are many <a href="/How_you_can_help">things you can do</a> to help us improve MTA - create a map, a gamemode, help document scripting functions, write example code, write tutorials or just play MTA and report the bugs you find.</p>
3232

3333
<p>If you have any questions or problems related to scripting, feel free to get in touch with us on <a href="https://discord.com/invite/mtasa" target="_blank">Discord</a>.</p>
3434

@@ -45,7 +45,7 @@ import { Icon } from '@astrojs/starlight/components';
4545
<ul>
4646
<li><a href="/Where_to_buy_GTASA">Where to buy GTASA</a></li>
4747
<li><a href="/Client_Manual">Client Manual</a></li>
48-
<li><a href="/Changes_in_current_version">Changes in Current Version</a></li>
48+
<li><a href={"/Changes_in_"+MTA_CURRENT_VERSION.full}>Changes in {MTA_CURRENT_VERSION.full}</a></li>
4949
<li><a href="/Known_Issues_-_FAQ">Known Issues</a></li>
5050
<li><a href="/Server_Manual">Server Manual</a></li>
5151
<li><a href="/Map_manager">Map Manager</a></li>

0 commit comments

Comments
 (0)