Skip to content

Latest commit

 

History

History
166 lines (116 loc) · 6.66 KB

CONTRIBUTING.md

File metadata and controls

166 lines (116 loc) · 6.66 KB

Contributing

If you feel like contributing there are a couple of ways to do this

  1. You can add new super high-speed code, optimizing existing code or rewrite for broader support of bash environments across *nix OS's

  2. You should not add domains to the submit_here/ folder of this repo. It has to be committed via an ISSUE.

    Because I do have some scripts that handle/maintains several things each time an issue is confirmed, like the DNS RPZ zone and the repository at once.

Submit - Contribute

All commits of new NSFW adult records should be done to Porn Records

You can use the following quick links

Category Commit issue
Adult contents https://mypdns.org/my-privacy-dns/porn-records/-/issues/new?issuable_template=Adult_contents
Adult CDN https://mypdns.org/my-privacy-dns/porn-records/-/issues/new?issuable_template=Adult_CDN
Strict Adult contents https://mypdns.org/my-privacy-dns/porn-records/-/issues/new?issuable_template=Strict_Adult_contents
Strict Adult CDN https://mypdns.org/my-privacy-dns/porn-records/-/issues/new?issuable_template=Strict_Adult_CDN
Snuff & gore https://mypdns.org/my-privacy-dns/porn-records/-/issues/new?issuable_template=Snuff
Common support https://mypdns.org/MypDNS/support/-/wikis/-/issues/new
Common wiki https://mypdns.org/MypDNS/support/-/wikis/

Workflow

Add new domains

This one is too simple or therefore probably too good to be true... right?

Nope, it is true. How can you contribute to 4 Blacklist with one issue + several RPZ Zone?

  1. You open an issue from the list above

    Issue comment

    you should know a couple of things about the issue templates, as I know a lot of people hates them as I suspect they don't understand the long-term and bigger idea behind them.

    Hopefully, the following text might help with that.

    • It is 1 domain = 1 issue
    • The templates are designed so nobody should have to visit any of the domains to verify, it is a pornographic domain, hence why the small screenshots of the site are required.
    • Everything should, at best, be designed to help others in their goal for maintaining and blacklisting adult-related material.
    • We shall always do our best to achieve this so that no one has to visit a pornographic site to verify it, once the team behind the project has done this.
    • They are designed to match another project (Long term), currently known as the matrix, yes because of a $2 domain while watching the matrix movie. https://mypdns.org/infrastructure/matrix-rocks/www.matrix.rocks/-/blob/master/README.md

  2. @spirillen will handle these regularly basis, which usual would be a couple of times a week.

IMPORTANT: Fill out any fields, or you will at first be requested to add missing values, if you fail to do this, your commitment can in sever cases end up being deleted.

Manage sub-domain in existing issue domains

Add then in the same style and with the usual minimum of need data in a comment to the primary domain, then if the report is confirmed, it will be edited into the original issue.

Each subdomain should have its own "master" comment.

In that way, you can challenge/comment to each sub-domain as things will change over time.

As practiced here: https://mypdns.org/my-privacy-dns/matrix/-/issues/201#note_32072

Click to expand

Manage sub-domains

Screenshot

Why @spirillen is so picky about the screenshots is due to the time available for him to handle this. You should also have read this comment

We prefer you upload your fresh screenshot directly to us, as hotlinking screenshots is bad in most ways, such as 3rd party tracking and other user data collection and tracking cookies. Minimize the number of hotlinks used, it's not forbidden as long this won't be abused. There are also cases where people simply block all 3rd party contents, they are not able to see any hotlinked contents.

New code

If you feel like adding new code or modifying existing code to make it run better, faster, smarter, etc. You will be editing and contributing to the code, automatically be redirected to a fork of the main repo, from where you add and/or modify the code.

When you are done with your contribution, you will save the file in a new branch. Don't forget to make a full reference to the issue in your commit message as a full URL to issue:

https://mypdns.org/my-privacy-dns/porn-records/-/issues/<ID>

Replace the <ID> with the issue id from https://mypdns.org/my-privacy-dns/porn-records/-/issues

new commit

Next you'll be taken to the Open a pull request

Open a pull request

When everything is filled out correctly, you just hit the Create pull request and you are done.

GPG signed

We require all submissions to be signed with a valid GPG key.

The only exception to this rule is the CI/CD bot.

How to sign with GPG

If you know nothing about GPG keys I suggest you search on duckduckgo for the best way to do it, on your current OS.

However, if you do have a GPG key, add it to your submission profile add a -S to the git commit -S -m "Some very cool enhancements" and that's is. You can set this globally or pr git. Search duckduckgo to figure out the current way.

Encoding when writing files/lines

  • All files must end with a newline \n(LF) UTF-8.
  • All files have to be in universal UTF-8 style without BOM
  • Any files or file location containing _windows_ in its files must be encoded in ISO-8859-1 Latin1 and newlines most end in (CRLF)
  • Line length should not be any longer than 80 chars for supporting terminals.

This version supersedes https://mypdns.org/MypDNS/support/-/wikis/Contributing

Revision date: 26. Nov 2021.

Last edited by: https://mypdns.org/Spirillen/

Approved by: https://mypdns.org/Spirillen/

Version: rPD 1.2