documentation
forgefed
documentation | forgefed | |
---|---|---|
19 | 20 | |
1,694 | 983 | |
0.2% | 0.2% | |
9.0 | 5.5 | |
8 days ago | 12 days ago | |
SCSS | Bikeshed | |
GNU Free Documentation License v1.3 | Creative Commons Zero v1.0 Universal |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
documentation
- We will be shutting down Post News within the next few weeks
-
A simple way to understand federation: with one user account you can participate in multiple servers, not needing to sign up on them separately. That's literally it.
The Fediverse is inherently difficult to understand and use. Their documentation, sadly, is written as a sales pitch for the federation piece of it, but doesn’t make it simple to understand. This summary is better, but parts of the explanation still don’t make sense when trying to access content. I couldn’t figure out how to see Mastodon toots from other servers, as an example.
-
Improving Mastodon developer documentation
My next task is triaging and labelling issues and pull requests in the documentation repo on GitHub, with an aim to bring in as many of those existing contributions as we can. I am particularly focused on the API, and I am not currently so familiar with other topics (Mastodon server installation, administration, etc), so I'll be relying on additional help! I am aware that some of the issues and PRs have been waiting for a while, but I'll do what I can to get things improved here.
-
possibly already asked, is it possible to use the same domain for mastodon, email, and a website?
that said, you can achieve what you're asking but it's tricky: https://github.com/mastodon/documentation/blob/archive/Running-Mastodon/Serving_a_different_domain.md
-
I wish to create a server but I have questions (TOS, other options, etc.)
I recommend you go through their documentation. It's very well written. https://docs.joinmastodon.org/
-
Should I create a new instance for the NBA?
I honestly begin going to the Mastodon docs and reading. https://docs.joinmastodon.org/
-
AMA with Eugen Rochko, Founder and lead developer of Mastodon, a decentralized, open-source social media platform based on open web protocols. Ask your questions here!
https://github.com/mastodon/documentation documentations are here. I guess you can upload your documentation in the manner in the style as seen there. Although the documentation that you want is more related to code.
-
Twitter will remove accounts created solely to promote other social platforms
Anyhow, if you want to really learn what it is about, their docs are actually good at explaining that https://docs.joinmastodon.org/, but it is definitely too much for normal people.
-
Integrating Mastodon with Astro
Before I dive in too far, let's talk about microblogging and federation as Mastodon describes it. For microblogging, the Mastodon docs say:
-
Almost there - nginx doesn't have permission to the mastodon dynamic website?
The only other issue I hit was getting certbot to work. I found the answer to that little problem via an update in this GitHub issue (namely: disable the site altogether, run certbot in standalone mode, and then enable the site and update the certs section). I need to push a PR for this as well, but wording it will be a pain.
forgefed
- Gitlab's ActivityPub architecture blueprint
- PyPy has moved to Git, GitHub
-
Harness launches Gitness, an open-source GitHub competitor
If you don't mind me asking since you're here: will you be implementing ForgeFed in Gitness [0]? My sense is that federation is our best hope for breaking GitHub's network effects, and I'd love to see more projects like yours join the protocol.
[0] https://forgefed.org/
- ForgeFed
-
Gitlab's plan to support ActivityPub for merge requests
From the comments, Forgejo is also already working on implementing ForgeFed, an ActivityPub extension specifically designed for software forges [0]. Judging from the issue, it looks like they're well on their way [1].
I have to say, I'm not super into the idea of social media, but this is a use for federation I approve of wholeheartedly. The friction of having to create accounts on X forges (where X is the number of projects that self-host GitLab) is a huge moat for GitHub, and federation could solve that very handily and create an environment where FOSS projects can feasibly host their own code away from Microsoft's control without horribly inconveniencing everyone who wants to participate.
[0] https://forgefed.org/
[1] https://codeberg.org/forgejo/forgejo/issues/59
-
git-appraise – Distributed Code Review for Git
> I agree that e-mail is not perfect, but... how is GitHub better?
Please look at my comment again. I prefer email to locked in forges.
> Devs like new shiny toys, and e-mails are old technology
There is one aspect where such forges have an advantage over email - a better user experience. Aerc and the likes all good - but Github and others provide a good user experience over a tool that everyone uses - the web browser.
> we should have something better than e-mail in 2023
We really should have something better than email. I'm saying this as someone who operates a personal mail server and a bunch of desktop services for it. It's really hard to get the setup correct.
In that context, it's worth looking at forgefed (https://forgefed.org/). It's a protocol for federating forges like Gitea and Gitlab. It's built on top of ActivityPub - which behaves a bit like email (it has inboxes and outboxes for every user). From the spec, it seems like pull requests happen by sending patches to the destination forge.
> Nobody takes the time to try the e-mail workflow (even though it's really two git commands)
Email workflow seems simple. But there are two things that make it complicated:
1. The patches don't specify the commits they apply to. It's simply assumed that they apply to the head of the main branch. The commits have to be carefully rebased on the main branch before sending the patches. It could otherwise lead to conflicts and a lot of wasted time.
2. Each commit/patch is send as a single email. Developers usually make frequent commits when they develop. Such patches can be confusing and hellish to review. A sane patchset requires the developers to edit the commit history, usually using interactive rebases. Each commit should contain a single feature and shouldn't break the build.
I consider both the above to be good development practices and follow them even on my personal projects. However, this is an additional barrier to entry. In fact, this may be a bigger problem for many than setting up git for email.
-
Leveling Up Your Git Server: Sharing Repos with a Friend
Another interesting topic to look into is forge federation. Forgejo [0], the code forge on which Codeberg is based is one forge software that intends to federate their repositories between server instances over the network using ActivityPub protocol extensions such as ForgeFed [1] and F3 [2] specifications.
[0] https://forgejo.org
[1] https://forgefed.org
[2] https://lab.forgefriends.org/friendlyforgeformat
- Sono Moreno di Morrolinux. AMA!
-
Let's Make Sure Github Doesn't Become the only Option
> If you want to look into people who disagree with you: https://forgefed.org/
What are some alternatives?
jekyll-webfinger - Webfinger endpoint generator for Jekyll.
kyoto - Golang SSR-first Frontend Library
Mastodon - Your self-hosted, globally interconnected microblogging community
gitness - Gitness is an Open Source developer platform with Source Control management, Continuous Integration and Continuous Delivery.
fritter - A peer-to-peer social feed app. (proof of concept)
cicada - A FOSS, cross-platform version of GitHub Actions and Gitlab CI
instances - Mastodon instances list
killed-by-microsoft - Part guillotine, part graveyard for Microsoft's doomed apps, services, and hardware.
GuideToMastodon - An increasingly less-brief guide to Mastodon
git-appraise - Distributed code review system for Git repos
mastodon - A glitchy but lovable microblogging server
gitlab