guida-fediverso/CONTRIBUTING.md

93 lines
4.4 KiB
Markdown
Raw Normal View History

2018-06-04 02:51:51 +02:00
# CONTRIBUTING
2018-11-16 23:44:50 +01:00
Don't hesitate to send a merge request.
2018-06-04 02:51:51 +02:00
2018-11-16 23:44:50 +01:00
### [Submitting software](submitting-software)
2018-06-04 02:51:51 +02:00
2018-11-17 00:07:00 +01:00
Tools submitted to **MORE APPS** website page **must be**:
2018-11-16 23:44:50 +01:00
* 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.
A project **must have** *title, source, protocols (1 string, comma separated), categories* and appropriate protocol classes marked as `true`.
Please, choose no more than **2 categories** (array of strings) for the tool. The ones it was initially designed for.
#### Categories (WIP, may change in the future)
* `SN-ma` (social network: macroblogging)
* `SN-mi` (social network: microblogging)
* `Blog-Pub` (blog and publishing software)
* `Media` (media sharing: images, audio, etc)
* `Links` (link sharing)
* `Ev-Meet` (events, meetups, calendars)
* `Files` (file hosting software)
* `Coop` (cooperatives, shared management)
* `Econ` (economic activities)
* `DevTools` (developer tools: libraries and such)
* `Plugins` (plugins)
A project may have a logo / image (45x45px), placed in `./source/img/misc` folder.
### [Submitting news](submitting-news)
2018-06-04 02:51:51 +02:00
**Data located in**: `/source/_posts` folder
**[Chronicles](https://fediverse.party/en/chronicles)** page aggregates latest news about major releases, development, interviews, related projects of Fediverse *social networks* (i.e., all the networks listed on main page).
2018-11-16 23:44:50 +01:00
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) ).
2018-06-04 02:51:51 +02:00
Every post **must have** the following __metadata__:
```
layout: "post"
title: "some title"
date: 2222-01-25
2018-06-04 02:51:51 +02:00
tags:
- pleroma
preview:
"short gist..."
url: "https://pleroma.social/link-to-news-source"
lang: en
```
`Tags`
2018-11-16 23:44:50 +01:00
A post may have one of these tags: fediverse, gnusocial, diaspora, friendica, hubzilla, mastodon, postactiv, pleroma, socialhome, ganggo, misskey, peertube, osada
2018-06-04 02:51:51 +02:00
`Preview`
Limit 150 characters - for "regular" and "wanted" posts, limit 350 characters - for "featured" post.
2018-11-16 23:44:50 +01:00
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.
2018-06-04 02:51:51 +02:00
__Optional metadata__:
```
wanted: true
featured: true
banner: "pic.jpg"
authors: [{"name": "John Snow", "url": "https://ggg.social", "network": "socialhome"}]
2018-06-04 02:51:51 +02:00
```
`Wanted`
Add this metadata to a post that you wish to show in the upper visible part of the Chronicles page. Calls for contribution, donations, help should be posted with this metadata.
`Featured`
Add this metadata to a new internal website's article, to show the post in a prominent part of the Chronicles page.
`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.
2018-06-04 02:51:51 +02:00
2018-06-04 16:36:52 +02:00
`Banner`
2018-11-16 23:44:50 +01:00
Required for "featured" posts only, an image wide enough to be used as a fullscreen background, should be placed in `/source/_posts/exact-post-file-name` folder. See [example](https://gitlab.com/fediverse/fediverse.gitlab.io/tree/master/source/_posts/fediverse-saves-from-pickup-artists-and-7-more-reasons-to-join).
2018-06-04 16:36:52 +02:00
`Authors`
Required for "featured" posts only. Add an array of object(s): name you wish to be shown as the author, and one website link. If it's the link to yout account on Fediverse, specify network name - lower case, without spaces.
2018-06-04 02:51:51 +02:00
2018-11-16 23:44:50 +01:00
### [Writing internal article](Writing-internal-article)
2018-06-04 02:51:51 +02:00
2018-11-16 23:44:50 +01:00
Each new internal article will be posted as "featured" in the prominent part of the Chronicles page, and will stay there for a while. It will also be distributed via RSS subscription. Your name will be featured as the author(s).
2018-06-04 02:51:51 +02:00
A merge request with an article will include all the things mentioned above for a `featured` post: a file placed in `/source/_posts` folder with necessary metadata, a 350-character preview and full text after metadata section, written in markdown. A banner image should be added to `/source/_posts/exact-post-file-name` folder that you'll create. Any other images used in the article may be placed there as well.
2018-11-16 23:44:50 +01:00
**Thanks!**