arivertisements/CONTRIBUTING.md
2025-08-16 21:41:48 +03:00

4.7 KiB

Contributing to Arivertisements

By contributing your Arivertisements ("images") to Arivertisements, you affirm that:

  • The image is your original, verifiable work.
  • You license your image under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0) (full license). This means your image can be shared, copied, distributed, remixed, adapted, and built upon non-commercially, provided proper credit is given, and derivative works use the same license.
  • Your image complies with Ari-web standards, including:
    • Abiding by International, Lithuanian, and German laws.
    • Maintaining a safe and respectful environment.
    • Upholding human decency, including:
      • Tolerance and non-discrimination (covering racism, homophobia, transphobia, sexism, xenophobia, fatphobia, and similar prejudices).
      • Avoiding misinformation and disinformation.
      • Taking responsibility and accountability for your actions.
      • Strictly prohibiting Child Sexual Abuse Material (CSAM) and any content promoting or implying approval of it.
      • Respecting others and following accepted norms of behaviour.
    • Not sharing personal or sensitive information (yours or others').
    • Respecting intellectual property rights and refraining from infringement.
    • No spam, harassment, stalking, or abusive behaviour.
    • Avoiding any harmful actions toward individuals, jurisdictions, or systems.
    • No sexually explicit or suggestive content.
    • Following administrator guidelines - any abusive behaviour may result in violation of these rules.
  • Your image does not include rapidly flashing lights.
  • You agree to allow free serving and optimization of your image.

To contribute, submit a (preferably) signed pull request:

  • Each commit (or all significant commits) should be cryptographically signed with OpenPGP (optional, but highly preferred)
  • Include a Signed-off-by line in your commits using your preferred or legal name, username, alias, or ID, plus a non-disposable public email.
    Signed-off-by: The Author <you@example.com>
    

Your pull request should:

  1. Add an image in the img directory with these requirements:
  • Dimensions: 722x84 pixels (or smaller, considering it may scale up to 722x84 without losing legibility).
  • Formats accepted: PNG, JPEG, GIF, BMP, SVG.
  • Maximum file size: 512 KB (524288 bytes).
  • Optimization is highly recommended (e.g, online tools like "PNG optimiser online", or locally using optipng for PNG (optipng -o9 my-ad.png), jpegoptim for JPEGs (jpegoptim my-ad.jpg), and gifsicle for GIFs (gifsicle --batch --optimize=3 my-ad.gif)), though you may keep EXIF metadata.
  • The image must render correctly in Chromium-based and Firefox-based browsers when embedded in an <img> tag.
  • The image content should not be explicitly promotional or require context to be understood. Simple images like a website domain on a plain background will not be accepted.
  1. Create a new file in the meta directory called the same as your image, except using .txt (for example, example-com-meow.png => example-com-meow.txt) including the following metadata in this format:
Filename: example-com-meow.png
To: https://... (where to take the user, optional)
Alt: Alternative text for blind folks.
Author: your name/username/ID/...
Contact: your at email.com (with the 'at' (it will be replaced with '@' to avoid scraping))
Statement: I hereby affirm that the image [REPLACE FILENAME HERE] is my own original and verifiable work, and I license it under the CC-BY-NC-SA-4.0 for use in the Arivertisements project.
Source: https://... (either original source, upstream source, or URL of your PR/commit, optional)
Fg: #abc (optional foreground colour)
Bg: #000 (optional background colour)

You may submit up to 5 Arivertisements per domain by the same author.

PRs

If you do not have a https://git.ari.lt/ account, you can copy this repository to your preferred git forge and commit there, emailing the URL to:

Arija A. <ari@ari.lt>

OpenPGP key ID (RSA4096): 5594A925063F3E68885A8F42B6B1654EDCB0F20C
OpenPGP key ID (ECC): 20A6FBAC2E07A6256E5A435A841A60BFE0406195

This will be registered as a pull request by a manual git pull <url>.

As a last resort, you can simply E-Mail me the meta file and the image and I will push an unsigned commit forged as you. Although, you must add explicit agreement to be forged and unsigned such as:

I am okay with you forging an unsigned git commit for me based on the provided metadata file and I affirm the contribution rules and conditions at https://git.ari.lt/ari.lt/arivertisements/src/branch/main/CONTRIBUTING.md.