search

ReVanced / revanced-documentation

🗄 Collection of all ReVanced documentation
https://revanced.app
GNU General Public License v3.0
271 stars 44 forks source link

Add specific guide for patching YouTube 'for dummies' to documentation #30

Closed jellie-bean closed 1 year ago

jellie-bean commented 1 year ago

Many people on reddit post with issues relating to patching YouTube specifically which takes over the subreddit. Would it be useful to link to the most useful guide on subreddit in the 'links, guides and faq section' itself under a heading such as: 'patching YouTube for dummies'?

The post in question I'm talking about is https://www.reddit.com/r/revancedapp/comments/xlcny9/revanced_manager_guide_for_dummies/

Post in question is quite detailed for patching YouTube and many people use. It could mean that users will read it first before posting issues if it was right there on the main faq page.

If there are only 'official' documentation that can be added then might I suggest adding something similar that is official. Since the manager is overwhelmingly used to patch YouTube and by people of all technological abilities right from those who have no idea what a patcher or an Apk is etc.

oSumAtrIX commented 1 year ago

ReVanced is App angostic by design, the official guide already covers patching and works globally for any app

jellie-bean commented 1 year ago

Then how about a 'patching for dummies' documentation section that is app agnostic? As obviously many people are still confused by the official documentation just having a look through reddit comments.

oSumAtrIX commented 1 year ago

If they are confused they are free to open an issue stating what exactly is confusing in detail for discussion

jellie-bean commented 1 year ago

Okay well when I get the time I can go through all of the documentation and suggest which sections are too complicated for the tech illiterate.

However a quick look through the documents for a few seconds. First the documents are too confusingly set up. Eg. Sub folders within folders.

It doesn't explain different between split APKs etc. I can't find a sentence that overtly states that the mangers is a patching client that can be used to patch all sorts of different apps not just YouTube.

I also found that in the section for 'documentation and guides' and then 'revanced manager' then 'patching' section. It doesn't mention anything about how to download APKs eg. From apkmirror. If this is elsewhere explained it is not obvious at all. It also doesn't say to click on the 'storage' button in the revanced manager to find the downloaded apk on your phone etc.

I think little things like this would make the documentation easier to understand for people who aren't aware of these kind if things.

oSumAtrIX commented 1 year ago

However a quick look through the documents for a few seconds. First the documents are too confusingly set up. Eg. Sub folders within folders.

That's the repository and correct semantical structure.

doesn't mention anything about how to download APKs eg. From apkmirror

ReVanced has nothing to do with ApkMirror, nor is it in charge of telling you where to source your APKs. The docs tell you that you have to source APKs yourself.

It also doesn't say to click on the 'storage' button i

Yes it does.

jellie-bean commented 1 year ago

Well this is what I'm saying. The section where it saying to 'select from storage' for non-root devices is hidden right at the bottom and I completely missed it and I'm sure others did. It could be laid out much more clearly.

Also having to click through 3 different links from the subreddit just to read about 3 lines is not user friendly. It would make more sense to group all of this info together on one page sonewhere rather than going through each individual section.

Also having a screenshot of the manager itself highlighting which sections do which could be helpful for visual people etc.

I can't find any sentence explaining in plain English what the manager is and what it does. Eg. It is for patching all sorts of different apps with different features not just youtube. These apps you must source the Apk for yourself and then patch using the manager. Then explaining what an Apk is and that you should source it yourself. The type of apk you download is important EG. split or not. and to check which version of the Apk is needed in the manager by looking here etc etc.

jellie-bean commented 1 year ago

I also think it would save you wonderful devs time by having to answer and sift through hundreds of the same questions everyday.

oSumAtrIX commented 1 year ago

It could be laid out much more clearly.

Explain how.

It would make more sense to group all of this info together on one page sonewhere rather than going through each individual section.

That would result in a wall of text, which is worse to read. The way it is currently structured divides each topic into different pages.

Also having a screenshot of the manager itself highlighting which sections do which could be helpful for visual people etc.

20

I can't find any sentence explaining in plain English what the manager is and what it does.

Check the description of the repo.

These apps you must source the Apk for yourself

That's already mentioned.

The type of apk you download is important EG. split or not. and to check which version of the Apk is needed in the manager by looking here etc etc.

Once again mentioned.

It is for patching all sorts of different apps with different features not just youtube.

YouTube has nothing to do with ReVanced Manager, as for why it won't be mentioned in an app agnostic guide

oSumAtrIX commented 1 year ago

it would save

What would