Rewrite FAQ.md and CONTRIBUTING.md

[Dum4G]

Rewrite of the Contributing Guide with a new structure and FAQ updates.
It now sets in stone:
Requirements that must be accomplished to accept the stream source
Common practices to distinguish publicly available source from leaked or protected one
Testing practices for the source
Explains logic behind channels sorting

If anything is missing, needs better phrasing or explanation please use the comment and suggestion features of Github

Preview:
https://github.com/iptv-org/iptv/blob/fe0c855fa0ca55c10557ad53e9af1bcfae852a6e/CONTRIBUTING.md
https://github.com/iptv-org/iptv/blob/fe0c855fa0ca55c10557ad53e9af1bcfae852a6e/FAQ.md

[Dum4G]

As per https://github.com/orgs/iptv-org/discussions/561 I do not accept links that I can't open in VLC and my current guides explain why. However, I saw in testing files that we may accept KODI arguments. At this point none of the playlists have a source that need those arguments. Are we accepting KODI now? Do we have to verify if the link works in KODI as well?

[BellezaEmporium]

It's quite niche for our usage right now as they're tons of other alternatives, but I hope not. Because if KODI support's official, welcome to DRM content and other kinds of protection bypass issues...

[freearhey]

I'm a bit confused. Is this section for people whose links aren't working, or is it a guide for contributors who want to add their links to the playlist?

[Dum4G]

I'm a bit confused. Is this section for people whose links aren't working, or is it a guide for contributors who want to add their links to the playlist?

For those who will not only add their links to the playlist but also test in VLC and at times find an obstacle (requirement of user-agent and/or refferer). May also be suitable in attempt to fix broken link

[freearhey]

Suggested change

	Before submitting a new stream make sure to acknowledge the [Requirements](#requirements) section and follow the [Validation](#validation) section of this Guide.
	2. Add the link to the playlist directly using a [pull request](https://github.com/iptv-org/iptv/pulls).
	🤚 Requests that do not comply with those sections will be closed immediately!
	Regardless of which option you choose, before posting your request please do the following:
	You have several options:
	- Make sure the link you want to add is stable, and works properly. To check this, open it in one of your usual players (for example, [VLC media player](https://www.videolan.org/vlc/index.html)) and watch the broadcast for at least a minute (some test streams are interrupted after 15-30 seconds).
	- Make sure the link is not already in the playlist. This can be done by [searching](https://github.com/search?q=repo%3Aiptv-org%2Fiptv+http%3A%2F%2Fexample.com&type=code) the repository.
	- Make sure the link does not lead to a Xtream Codes server. [Why don't you accept links to Xtream Codes servers?](FAQ.md#why-dont-you-accept-links-to-xtream-codes-servers). If you're unsure, please check [How to distinguish a link to an Xtream Codes server from a regular one?](#how-to-distinguish-a-link-to-an-xtream-codes-server-from-a-regular-one)
	- Make sure that the link leads directly to the broadcast, without unnecessary redirects.
	- Find the ID of the channel you want on [iptv-org.github.io](https://iptv-org.github.io/). If your desired channel is not on the list, you must add it via a request [here](https://github.com/iptv-org/database/issues/new/choose).
	- Make sure the channel is not blacklisted. It can also be done through [iptv-org.github.io](https://iptv-org.github.io/).
	- If you know that the broadcast only works in certain countries or it is periodically interrupted, do not forget to indicate this in the request.
	- Create a new request by manually filling this [form](https://github.com/iptv-org/iptv/issues/new?assignees=&labels=streams:add&projects=&template=1_streams_add.yml&title=Add%3A+) and if approved, the link will automatically be added to the playlist on the next update.
	- Use https://iptv-org.github.io/ to submit a stream for appropriate feed of the channel. To do that find a channel and press the feed link.
	<img width="892" height="70" alt="image" src="https://github.com/user-attachments/assets/c1bee428-d8a5-4c80-b961-43f1f25e2be4" />
	A request without a valid stream ID or working link to the stream will be closed immediately.
	Then press a ➕ sign if it is required to add an additional feed first or press 3 dots over appropriate feed and choose Add Stream.
	<img width="770" height="387" alt="image" src="https://github.com/user-attachments/assets/097087a1-da7e-4159-849d-baef552a0918" />
	This will submit a filled form that will be reviewed the same way.
	- Add the link to the playlist directly using a [pull request](https://github.com/iptv-org/iptv/pulls).
	Follow the [Playlist Structure](#playlist-structure) and [Stream Description Scheme](#stream-description-scheme) if you have considered that way.
	If you're adding an alternative link please do not replace any other link that might be working for some.
	Before submitting a new feed link, please make sure it meets the following requirements:
	- Make sure the link has not been submitted into the repository before. This can be done by searching the [repository](https://github.com/search?q=repo%3Aiptv-org%2Fiptv+http%3A%2F%2Fexample.com&type=code) or [website](https://iptv-org.github.io/).
	- Each submitted stream link must have a registered Channel & Feed ID (eg: `ChannelID@FeedID`) in our database. A complete list of channels and feeds can be found at [iptv-org.github.io](https://iptv-org.github.io). If it's not present, please follow the [Database Contributing Guide](https://github.com/iptv-org/database/blob/master/CONTRIBUTING.md) to add it.
	- Channels under DMCA takedown notices or broadcasting copyrighted content (such as the Champions League) will not be accepted (see the [blocklist](https://github.com/iptv-org/database/blob/master/data/blocklist.csv) for details).
	- The same applies to channels that are known to partially or fully broadcast [NSFW](https://en.wikipedia.org/wiki/Not_safe_for_work) content.
	- Links must not have any effective restrictions that limit viewers by authorization, by viewer count or by designated IP.
	- Test period links are not permitted.
	- It should be possible to play the stream using VLC media player (see the [FAQ](https://github.com/iptv-org/iptv/blob/master/FAQ.md) for more details).
	- If the host server requires a specific user-agent and/or a referer, is geo-blocked or may have downtimes, you should represent that in your contribution.
	- If possible please provide an adaptive link that covers every available resolution for a broadcast.
	If everything is in order, you have a few options:
	- Create a new request by filling this [form](https://github.com/iptv-org/iptv/issues/new?assignees=&labels=streams:add&projects=&template=1_streams_add.yml&title=Add%3A+) and if approved, the link will automatically be added to the playlist on the next update.
	- Add the link to the playlist directly using a [pull request](https://github.com/iptv-org/iptv/pulls). If you choose this option, please follow the [Playlist Structure](#playlist-structure) and [Stream Description Scheme](#stream-description-scheme). If you add an alternative link, please do not replace the existing one with it, as it may still work for other users.

[freearhey]

Suggested change

	## Link Requirements
	Before submitting new streams you should verify the following:
	- Make sure the link has not been submitted into the repository before. This can be done by searching the [repository](https://github.com/search?q=repo%3Aiptv-org%2Fiptv+http%3A%2F%2Fexample.com&type=code) or [iptv-org website](https://iptv-org.github.io/).
	- Each submitted stream link must have a registered Channel & Feed ID (eg: Channel@Feed) in the [iptv-org's Database](https://iptv-org.github.io). If it's not present, please follow the [Database Contributing Guide](https://github.com/iptv-org/database/blob/master/CONTRIBUTING.md) to add it. Otherwise, your stream links won't be delivered into automated playlists and won't be sorted out properly.
	- User-submitted links to stream URLs shall be intended to be publicly available by stream provider and the copyright holders.
	- Channels under DMCA takedown notices or broadcasting copyrighted content (such as the Champions League) at any time will not be accepted, see the [Channel blocklist](https://iptv-org.github.io/?q=is_blocked%3Atrue) and the [History of related issues](https://github.com/iptv-org/database/blob/master/data/blocklist.csv) for details.
	- The same applies to channels that are known to partially or fully broadcast NSFW content (nudity & extreme acts), see the [Channel blocklist](https://iptv-org.github.io/?q=is_nsfw%3Atrue), the [History of related issues](https://github.com/iptv-org/database/blob/master/data/blocklist.csv) and https://github.com/iptv-org/iptv/issues/15723 for more details.
	- User-submitted links must not have any effective restrictions that limit viewers by authorization, by viewer count or by designated IP.
	- Test period links are not permitted.
	- User-submitted links must open in VLC media player (see the [FAQ](https://github.com/iptv-org/iptv/blob/master/FAQ.md) for more details).
	- If the host server requires a specific user-agent and/or a referer, is geo-blocked or may have downtimes, you should represent that in your contribution (see the [Stream Description Scheme](#stream-description-scheme)).
	- If possible please provide an adaptive link that covers every available resolution for a broadcast.
	- Follow the [Playlist Structure](#playlist-structure) in case of contributing by pull requests.

[freearhey]

Since everything here is already listed in the Link Requirements above, I think we can remove this section entirely.

[freearhey]

And since the remaining two sections are not required reading before making a contribution, they could probably be moved to the FAQ.

[Dum4G]

So you want Members to do that stuff or to send two files for people that won't follow those sections?

[freearhey]

I think that if a request doesn't meet the requirements, it's enough to label it and close it. And if anyone has further questions, you can redirect them to the "Contributing Guide" or "FAQ". That's essentially how it works right now.

[Dum4G]

Exactly. And that's why it's reasonable to provide one file. And if the Contributing Guide is not required reading before making a contribution that kind of defeats the purpose of it's existance as an argument why something wasn't approved and what is expected

[freearhey]

I suggest moving only the "Examples" and "Stream Testing" sections to the FAQ. Everything else should remain in the guide.

[freearhey]

I’m not suggesting we delete this text. I’m just suggesting we move it to a separate file and add links to it from the existing rules:

• User-submitted links to stream URLs must be publicly available as intended by the stream provider and the copyright holders.
• User-submitted links must not have any restrictions that limit viewers based on authorization, viewer count, or specific IP addresses.
• If the host server requires a specific user-agent and/or a referrer, is geo-blocked, or may experience downtime, you should indicate that in your post

If you feel that the FAQ isn't suitable for this, we can just create a new file for all these tips.

[Dum4G]

What problem does the separation solve? We have already moved the text as links to a later part of the document

[freearhey]

My sole goal here is to ensure that the guide continues to contain only the bare minimum of information necessary for working with this repository. That's the only way there's even a small chance that people will actually read it. Again, if someone is interested in the topic, they'll find places to read about it besides our repository.

[Dum4G]

I don't see the guide to be meaningful if it doesn't provide clearance for the way we think and stuff we do before making a decision to do something. I see no achievement in "finding places" for essential knowledge and frankly I don't expect everyone to be that much interested in making a research between at least three? documents. Most people expect a single clear instruction for whatever they try to acomplish. In fact, if some can't completely follow the document the result is predictable and that better be one place

[freearhey]

Well, I guess we have different views on the purpose of this guide. For me, it’s not a place to learn something new, but rather a purely practical document that can be referenced in the requests. But maybe it's just me, and the rest of the community actually wants these changes.