Intro To Mastohacking: Difference between revisions

Revision as of 02:58, 5 December 2023

Where to get started when looking at the mastodon's underbelly

Here's what i'll go ahead and do is make some skeleton of the different subsystems and how to get started understanding what they do and then make this page publicly editable -jonny 2023-12-04

Main repo: https://github.com/mastodon/mastodon/
Our parent fork: https://github.com/glitch-soc/mastodon
Our fork (what actually runs on neuromatch.social): https://github.com/NeuromatchAcademy/mastodon
- See also the rest of the wiki which describes what we gone and done, particularly Tech WG,

Overview

What are the main parts of a Mastodon

Subsystems

Frontend - React

Redux

Discord

sneakers.the.rat#onboarding and instance docs23-12-05 06:58:02

OK <@318247805124870145> i'm doing a little wiki gardening rn and here i'll narrate a little of what i'm doing as i do it to give you a sense of what that looks like:

first i am reading this and wondering how i could offer part of this to you, and with this set of prompts and with ur previous comments about 'where do i even start with this thing' which are extremely justified i want to make a 'how to get started with masto as software' page, so I go to where we have previously put such things on the Tech WG page (https://wiki.neuromatch.social/Tech_WG ) and add a link there to a new Intro To Mastohacking page ( https://wiki.neuromatch.social/Intro_To_Mastohacking ) since i figure "intro to mastodon" is too much like our general getting started on fedi pages. idk we can always change it later.

So then i do a search for "docs" to see where else we might have written stuff like this and lo and behold there's also a page for that, so i add a link from there too: https://wiki.neuromatch.social/Mastodon/Docs

then i start my new page by adding categories and backlinks. Don't worry about the syntax for right now, but what i'm doing here is making this page findable in a few different ways - by navigating from related pages, formally through the semantic relationship `Part Of`, and then also via the category system (which we can also query to eg. display a list of all pages in the "hacking" and "guide" categories if we want to make some automatic index, but i digress).

nothing on the page yet but that? fuck it, save page. we can keep saving as we update, no need to be shy on wiki

(sorry for notifs el i'm going to split this up into a few messages so i can intersperse images)

@@ Line 25: / Line 25: @@
 === ===
+== Discord ==
+{{Message
+|Author=sneakers.the.rat
+|Avatar=https://cdn.discordapp.com/avatars/305044217393053697/2970b22bd769d0cd0ee1de79be500e85.png?size=1024
+|Date Sent=23-12-05 06:58:02
+|Channel=onboarding and instance docs
+|Text=OK <@318247805124870145> i'm doing a little wiki gardening rn and here i'll narrate a little of what i'm doing as i do it to give you a sense of what that looks like:
+first i am reading this and wondering how i could offer part of this to you, and with this set of prompts and with ur previous comments about 'where do i even start with this thing' which are extremely justified i want to make a 'how to get started with masto as software' page, so I go to where we have previously put such things on the Tech WG page (https://wiki.neuromatch.social/Tech_WG ) and add a link there to a new [[Intro To Mastohacking]] page ( https://wiki.neuromatch.social/Intro_To_Mastohacking ) since i figure "intro to mastodon" is too much like our general getting started on fedi pages. idk we can always change it later.
+So then i do a search for "docs" to see where else we might have written stuff like this and lo and behold there's also a page for that, so i add a link from there too: https://wiki.neuromatch.social/Mastodon/Docs
+then i start my new page by adding categories and backlinks. Don't worry about the syntax for right now, but what i'm doing here is making this page findable in a few different ways - by navigating from related pages, formally through the semantic relationship `Part Of`, and then also via the category system (which we can also query to eg. display a list of all pages in the "hacking" and "guide" categories if we want to make some automatic index, but i digress).
+nothing on the page yet but that? fuck it, save page. we can keep saving as we update, no need to be shy on wiki
+(sorry for notifs el i'm going to split this up into a few messages so i can intersperse images)
+|Link=https://discord.com/channels/1049136631065628772/1179563696830292069/1181489645989666916
+}}