Add guidelines, edit contributing, fix links

This commit is contained in:
lostinlight 2020-01-03 17:08:36 +03:00
parent ce313b2b4f
commit e7912051c9
4 changed files with 38 additions and 19 deletions

View file

@ -33,9 +33,11 @@ A project may have a logo / image (45x45px), placed in `./source/img/misc` folde
### [Submitting news](submitting-news)
Please, read our [guidelines](./GUIDELINES.md) for guest authors.
**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).
**[Chronicles](https://fediverse.party/en/chronicles)** page aggregates latest news about federating software, interviews with developers, first-person narratives, Fediverse related research and analysis.
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) ).
@ -56,7 +58,9 @@ authors: [{"name": "John Snow", "url": "https://ggg.social", "network": "socialh
```
`Tags`
A post may have one of these tags: fediverse, gnusocial, diaspora, friendica, hubzilla, mastodon, postactiv, pleroma, socialhome, ganggo, misskey, peertube, osada
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.
`Preview`
Limit 150 characters - for "regular" and "wanted" posts, limit 350 characters - for "featured" post.
@ -71,23 +75,17 @@ banner: "pic.jpg"
```
`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.
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.
`Featured`
Add this metadata to a new internal website's article, to show the post in a prominent part of the Chronicles page.
Add this metadata to a guest post, long-form 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.
`Banner`
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).
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://gitlab.com/fediverse/fediverse.gitlab.io/tree/master/source/_posts/fediverse-saves-from-pickup-artists-and-7-more-reasons-to-join).
`Authors`
Required. 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 your account on Fediverse, specify network name - lower case, without spaces.
### [Writing internal article](Writing-internal-article)
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).
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.
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.
**Thanks!**

22
GUIDELINES.md Normal file
View file

@ -0,0 +1,22 @@
# GUIDELINES
Thanks for considering to write for Fediverse.Party.
Contact [@lostinlight](https://mastodon.xyz/@lostinlight) via a Direct Message in case of any questions or if you need help with brainstorming ideas for an article, proofreading, conducting an interview.
Here are some guidelines that may help:
0. Fediverse.party covers all software federating via one of the four protocols: OStatus, diaspora, Zot, ActivityPub - your article will most likely be about one or several of such projects.
1. If you have already published something interesting about federated networks on your blog or personal website, the link to your external article may be added to the relevant section of this website. We'd like to post unique content as internal articles rather than mirror content already published somewhere else.
2. This website's target audience is newcomers to Fediverse. They may or may not have any technical background. Don't hesitate to explain simple "evident" concepts - it's better than assuming everyone will understand.
3. Articles are fun with illustrations. A banner illustration is required for the header, but may be you'll think of more images to make your narration visually appealing. If you need help with finding suitable images, contact [@lostinlight](https://mastodon.xyz/@lostinlight).
4. We all believe in something and support someone, we all differ in our preferences. Try to avoid religious and political aspects where possible. Please, be inclusive.
5. Laughter is the best medicine! Jokes highly appreciated in any narration, as long as they respect all human beings and aren't too niche (we'd like readers to understand them:).
Read [Contributing](./CONTRIBUTING.md) for technical details.

View file

@ -9,7 +9,6 @@ preview:
"The Internet is huge, with millions of websites. But Internet users concentrate on large well-known platforms. We are all familiar with the names of Facebook, Instagram, Twitter, Weibo, Vkontakte, Google, YouTube, Tinder. These services may be useful, but they are not the only ones"
url: "/en/post/fediverse-saves-from-pickup-artists-and-7-more-reasons-to-join"
lang: en
featured: true
banner: "banner.jpg"
authors: [{"name": "@lostinlight", "url": "https://mastodon.xyz/@lightone", "network": "mastodon"}]
---

View file

@ -17,14 +17,14 @@
<input name="slideout" id="f-menu" class="control" type="radio">
<ul class="nav slideout">
<label for="overlay"></label>
<li><a href="<%- url_for('/en/fediverse') %>"><svg class="f-icon"><use xlink:href="#icon-star"></use></svg> <span>Fediverse</span></a></li>
<li><a href="<%- url_for('en/chronicles') %>"><svg class="f-icon"><use xlink:href="#icon-star"></use></svg> <span><%- __('chronicles') %></span></a></li>
<li><a href="<%- url_for('en/knowledge') %>"><svg class="f-icon"><use xlink:href="#icon-star"></use></svg> <span><%- __('knowledge') %></span></a></li>
<li><a href="<%- url_for('en/miscellaneous') %>"><svg class="f-icon"><use xlink:href="#icon-star"></use></svg> <span><%- __('more') %></span></a></li>
<li><a href="<%- url_for('en/portal/servers') %>"><svg class="f-icon"><use xlink:href="#icon-star"></use></svg> <span><%- __('portal') %></span></a></li>
<li><a href="/en/fediverse"><svg class="f-icon"><use xlink:href="#icon-star"></use></svg> <span>Fediverse</span></a></li>
<li><a href="/en/chronicles"><svg class="f-icon"><use xlink:href="#icon-star"></use></svg> <span><%- __('chronicles') %></span></a></li>
<li><a href="/en/knowledge"><svg class="f-icon"><use xlink:href="#icon-star"></use></svg> <span><%- __('knowledge') %></span></a></li>
<li><a href="/en/miscellaneous"><svg class="f-icon"><use xlink:href="#icon-star"></use></svg> <span><%- __('more') %></span></a></li>
<li><a href="/en/portal/servers"><svg class="f-icon"><use xlink:href="#icon-star"></use></svg> <span><%- __('portal') %></span></a></li>
<li class="source">
<div class="u-extra">
<a href="https://github.com/distributopia/all-logos-in-one-basket"><%- __('logo') %></a>
<a href="https://gitlab.com/distributopia/all-logos-in-one-basket"><%- __('logo') %></a>
<a href="https://git.feneas.org/feneas/fediverse"><%- __('code') %></a>
</div>
<div id="pulse" class="source__toggle">