libretro / libretro/docs

The Facebook Portal page is AI-generated and almost nonsensical

Open
#893 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug
Dominant language
TeX
Stars
346
Forks
860
Avg merge
5d 16h
Merged PRs (30d)
7

Description

Describe the bug
The installation on Facebook Portal page is simply a guide for using the web interface, but is filled with duplicate statements and constant reminders that it's not designed for this, seemingly spliced from a bunch of different AI queries.

Here are some examples:

To run RetroArch on Facebook Portal, you would need to use browser. Remember that running RetroArch on Facebook Portal might not provide the best gaming experience. The device is primarily designed for video calling and might not have the same performance or compatibility as dedicated gaming devices or computers. So, while it's possible to run RetroArch on Facebook Portal, it might not be the ideal setup for gaming purposes.

Portal is built on an open-source Android platform but we can't access the Google Play Store. [no content between these lines]
Sure! Here's a step-by-step guide to running RetroArch on Facebook Portal:

Run the homebrews: After selecting the core, go to the "Downloads" section under the main menu. Look for the homebrews available for the console you selected. Homebrews are unofficial games or software created by independent developers. Select the file and it will load. [why only homebrews? why not legal dumps?]

Remember, running RetroArch on Facebook Portal might not offer the best gaming experience, as the device is primarily designed for video calling. So, manage your expectations accordingly, and have fun exploring the world of retro gaming!

Expected behavior/changes
This should probably be replaced with a link to the web guide, or removed entirely, as the process is not any different

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Open the Facebook Portal installation page linked in the issue and compare it with the existing web interface guide. Decide whether to remove the page or replace its contents with a link to the web guide, then verify that the resulting documentation no longer contains the duplicated or misleading instructions.

Written by the indexing model from the issue text.

Assessment

Tech stack
android
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.