CONTRIBUTING.md 6.18 KB
Newer Older
lostinlight's avatar
lostinlight committed
1 2 3

# CONTRIBUTING

4 5 6
Don't hesitate to send a merge request or to open an issue.

Also, check out our [Wiki pages](https://git.feneas.org/feneas/fediverse/-/wikis/home)
lostinlight's avatar
lostinlight committed
7

8
### [Submitting software](#submitting-software)
lostinlight's avatar
lostinlight committed
9

10 11 12 13 14
**Software** here is "a) project that can be installed on a server and self-hosted b) project that may be interesting to the general public, independent of their technical knowledge".

If your project targets mainly *developers*, tech-savvy users or is a helper (reference library, bot, relay, etc), please, submit it to **TOOLS** page (see below).

Software submitted to **ALL APPS** website page **must be**:
15 16 17 18 19
* Fully open source (please, consider showcasing your closed source apps on https://the-federation.info)
* Supporting or planning to support one of the following protocols: OStatus, diaspora, Zot, ActivityPub (please, consider showcasing your apps federating via other protocols on https://the-federation.info)

Fork this repository. Add your project data to `./source/_data/miscellaneous.json` file.

20
A project **must have** *title, source, protocols (1 string, comma separated), license, categories* and appropriate protocol classes marked as `true`. Project's description (`about`) shouldn't excede 200 characters limit.
21

22
Please, choose no more than **3 categories** (array of strings) for the software. The ones it was initially designed for.
23

24
#### Software categories (WIP, may change in the future)
25 26 27
* `SN-ma` (social network: macroblogging)
* `SN-mi` (social network: microblogging)
* `Blog-Pub` (blog and publishing software)
28
* `Media` (media sharing: images, audio, video, etc)
29 30 31 32
* `Links` (link sharing)
* `Ev-Meet` (events, meetups, calendars)
* `Files` (file hosting software)
* `Econ` (economic activities)
33
* `Open data` (dataset / corpora exchange)
34 35
* `Reviews` (networks whose main purpose is reviewing stuff)
* `Games` (gaming servers and apps)
36
* `Develop` (software development applications: version control services, pastebins, etc)
37
* `Extention` (services and tools extending Fediverse functionality: adding groups, etc)
38
* `Forum` (forums and forum-like software, boards, etc)
39
* `Other` (everything that doesn't quite fit into the above categories)
40 41 42 43 44 45

A project may have a logo / image (45x45px), placed in `./source/img/misc` folder.

### [Submitting tools](#submitting-tools)
Fork this repository. Add your project data to `./source/_data/tools.json` file.

46 47 48 49
A project **must have** *title, source, protocols (1 string, comma separated), license, categories* and appropriate protocol classes marked as `true`. Project's description (`about`) shouldn't excede 200 characters limit.

Please, choose no more than **2 categories** (array of strings) for the software. The ones it was initially designed for.

50
#### Tools categories (WIP, may change in the future)
51 52
* `Libs` (frameworks, libraries, reference implementations in particular code language)
* `Specs` (Fediverse protocol specifications)
53
* `Utils` (Utilities: daemons, bots, resharers)
lostinlight's avatar
lostinlight committed
54
* `Relays` (Fediverse relays)
55 56 57 58
* `Bridges` (bridging other stuff to fediverse networks)
* `Tests` (any kind of test tools)
* `Plugins` (CMS plugins, apps to be installed inside other systems connecting to Fediverse)
* `Other` (everything that doesn't quite fit into the above categories)
59

60 61
A project may have a logo / image (45x45px), placed in `./source/img/misc` folder.

62
### [Submitting news](#submitting-news)
lostinlight's avatar
lostinlight committed
63

64 65
Please, read our [guidelines](./GUIDELINES.md) for guest authors.

lostinlight's avatar
lostinlight committed
66 67
**Data located in**: `/source/_posts` folder

68
**[Chronicles](https://fediverse.party/en/chronicles)** page aggregates latest news about federating software, interviews with developers, first-person narratives, Fediverse related research and analysis.
lostinlight's avatar
lostinlight committed
69

70 71
Posts are available via [RSS](https://fediverse.party/atom.xml) subscription.
`Preview` is rendered on Chronicles page (limited ammount), text after metadata is shown in RSS (unlimited) and on post's page (see [Tags](https://fediverse.party/tags) ).
lostinlight's avatar
lostinlight committed
72 73 74 75 76 77

Every post **must have** the following __metadata__:

```
layout: "post"
title: "some title"
78
date: 2222-01-25
lostinlight's avatar
lostinlight committed
79 80 81 82 83 84
tags:
    - pleroma
preview:
  "short gist..."
url: "https://pleroma.social/link-to-news-source"
lang: en
85
authors: [{"name": "John Snow", "url": "https://ggg.social", "network": "socialhome"}]
lostinlight's avatar
lostinlight committed
86 87 88
```

`Tags`
89 90 91
A tag is either "fediverse" for general articles or the title of a particular Fediverse project.

A post may have one of these tags: actorscafe, anfora, commonspub, diaspora, distbin, dokieli, dolphin, epicyon, fediblog, fediverse, forgefed, friendica, funkwhale, gancio, gnusocial, groundpolis, guppe, honk, hubzilla, kanzaki, kibou, kroeg, lemmy, mastodon, microblogpub, misskey, mobilizon, moontree, nautilus, peertube, pixelfed, pleroma, plume, prismo, p3k, reel2bits, rustodon, social (for NextCloud Social), smithereen, socialhome, writefreely, zap.
lostinlight's avatar
lostinlight committed
92 93 94

`Preview`
Limit 150 characters - for "regular" and "wanted" posts, limit 350 characters - for "featured" post.
95
Please, stay within the limits in preview, otherwise it gets truncated half-sentence and will be posted that way on the Chronicles front page. Not good.
lostinlight's avatar
lostinlight committed
96 97 98 99 100 101 102 103 104 105

__Optional metadata__:

```
wanted: true
featured: true
banner: "pic.jpg"
```

`Wanted`
106
Add this metadata to a post that you wish to show in the upper visible part of the Chronicles page. Calls for contribution, calls for donations, calls for help should be posted with this metadata.
lostinlight's avatar
lostinlight committed
107 108

`Featured`
109
Add this metadata to a guest post, long-form article, to show the post in a prominent part of the Chronicles page.
lostinlight's avatar
lostinlight committed
110

111
`Wanted` and `featured` can't be mixed and are temporary. This metadata must be removed from an older post when creating a new "featured" or "wanted" post.
lostinlight's avatar
lostinlight committed
112

lostinlight's avatar
lostinlight committed
113
`Banner`
114
Required for "featured" posts only, an image wide enough to be used as a fullscreen background (~1920px), should be placed in `/source/_posts/exact-post-file-name` folder. Any other images used in this article may be placed there as well. See [example](https://git.feneas.org/feneas/fediverse/tree/master/source/_posts/fediverse-saves-from-pickup-artists-and-7-more-reasons-to-join).
lostinlight's avatar
lostinlight committed
115 116

`Authors`
117
Required. Add an array of object(s): name you wish to be shown as the author, and one website link (preferably link to your Fediverse profile). If it's the link to your account on Fediverse, specify network name - lower case, without spaces.
lostinlight's avatar
lostinlight committed
118

119
**Thanks!**