Skip to main content

๐Ÿค Contribute to this Wiki

Introductionโ€‹

The Fydetab Duo Wiki is a multilingual wiki built with Docusaurus, aiming to provide comprehensive documentation support for the Fydetab Duo tablet. This guide will walk you through different ways to contribute to this wiki.

File Structure and Contribution Suggestionsโ€‹

Below is a list of all directories and main files related to the wiki content. If you find an error in the wiki documentation, you can locate the corresponding source file here, make modifications, and submit the updated file.

fydetabduo-wiki/
โ”œโ”€โ”€ docs/ # Documentation directory, controls the English part of this wiki
โ”‚ โ”œโ”€โ”€ 1.intro.md
โ”‚ โ”œโ”€โ”€ 2.Operating system options.md
โ”‚ โ”œโ”€โ”€ 3.Flashing the Fydetab Duo.md
โ”‚ โ”œโ”€โ”€ 5.Key hardware components.md
โ”‚ โ”œโ”€โ”€ 6.Unbrick your Fydetab Duo.md
โ”‚ โ”œโ”€โ”€ 7.Contribute to wiki.md
โ”‚ โ”œโ”€โ”€ Available-OS/
โ”‚ โ”œโ”€โ”€ Hacking-the-Fydetab-Duo/
โ”‚ โ””โ”€โ”€ Recipes/
โ”œโ”€โ”€ i18n # Multilingual directory
โ”‚ โ””โ”€โ”€ zh-Hans # Simplified Chinese translation files
โ”‚ โ”œโ”€โ”€ code.json
โ”‚ โ”œโ”€โ”€ docusaurus-plugin-content-docs
โ”‚ โ”‚ โ”œโ”€โ”€ current
โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ 1.intro.md
โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ 2.Operating system options.md
โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ 3.Flashing the Fydetab Duo.md
โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ 5.Key hardware components.md
โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ 6.Unbrick your Fydetab Duo.md
โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ 7.Contribute to wiki.md
โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ Available-OS/
โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ Hacking-the-Fydetab-Duo/
โ”‚ โ”‚ โ”‚ โ””โ”€โ”€ Recipes/
โ”‚ โ””โ”€โ”€ docusaurus-theme-classic/
โ””โ”€โ”€ static/ # Static resources directory
โ”œโ”€โ”€ img/ # Image resources directory
โ”œโ”€โ”€ robots.txt
โ””โ”€โ”€ CNAME

If you find minor text-level errors in the wiki documentation, such as spelling mistakes or translation errors, you can choose to make direct edits via GitHub and submit them for contribution.

If you want to restructure a document, add new documentation, or supplement full translation content, we recommend using GitHub Codespace for contribution: first create a workspace and modify the source code, then compile the wiki, confirm that the modifications meet your expectations, and finally submit the changes for contribution.

Prepare a GitHub Accountโ€‹

Regardless of the method you choose, you will need a GitHub account. For instructions on registering a GitHub account, please refer to GitHub's official documentation.

Fork the Source Code to Your Accountโ€‹

On the project's GitHub page, click the Fork button on the right side to fork a copy of the Fydetab Duo Wiki source code to your account.

Making Changesโ€‹

Direct Editing via GitHubโ€‹

In your forked repository, locate the file you wish to modify, click the edit file button in the upper right corner, and edit the source code online. After editing, the changes will be stored directly in your fork.

If you are unsure which file to modify, you can find an Edit this page link at the bottom of each page on the Fydetab Duo Wiki. Clicking this link will take you to the corresponding source file page.

Edit and Preview with GitHub Codespaceโ€‹

GitHub Codespaces is a cloudโ€‘based instant development environment that lets you get a fully containerized workstation preโ€‘configured with all dependencies in seconds via your browser. This project already includes a devcontainer configuration file, so you can easily use GitHub Codespace to create a fast environment for editing and previewing the compiled wiki.

Launch Codespace and Modify Codeโ€‹

Go to your forked repository page, click the Code button and select the Codespaces tab, then click the + button. This will create a Codespace based on your forked code. After a short wait, your browser will enter the VS Code Web interface, which is your workspace. Here you can modify the source code of this wiki.

create_codespace

For an introduction to the VS Code interface and basic usage, please refer to its official documentation.

codespace_view

Compile and Previewโ€‹

After making your changes, you can open a terminal (Ctrl + ` or Ctrl + Shift + C), run yarn build, and once that completes, run yarn serve. The terminal will display a temporary URL through which you can preview the modified wiki site.

review_wiki

Save Your Changesโ€‹

Once you are satisfied with the modifications, you can use the builtโ€‘in Git management features of VS Code Web to stage, commit, and push your code, thereby storing and pushing your changes to your forked repository on GitHub. For more information, see VS Code's official documentation.

Submit a Pull Requestโ€‹

After your changes are saved to your forked repository, you can submit a pull request to request merging your modifications into the original Fydetab Duo repository. Once the pull request is accepted by the Fydetab Duo Wiki maintainers, your changes will be visible on the Fydetab Duo Wiki.

For detailed instructions on creating a pull request, please refer to GitHub's official documentation.

Notesโ€‹

  1. Translation files (i18n) must have exactly the same name as the original files to work properly.
  2. Static files: If you need to add screenshots or other static files to the documentation, place them under the static folder and access them using paths like /img/your_img.png.
  3. Document numbering: Please assign appropriate numbers to document files so that they appear in the intended order.

For more information, you can refer to the Docusaurus official documentation.