Skip to content

Latest commit

 

History

History
86 lines (69 loc) · 4.55 KB

CONTRIBUTING.md

File metadata and controls

86 lines (69 loc) · 4.55 KB
Raw

Contributing to "AM"

First off, thanks for taking the time to contribute!

Found a Problem?

Before reporting a problem, be it a bug, design or others, we assume you have made sure that:

  1. the README.md does not cover your problem
  2. the problem has not been reported in the issue tracker
  3. the problem is not related to the installed apps but to the installation scripts
  4. the "AM"/"AppMan" command line interface is updated to the latest version

If all apply, then please consider opening a new issue.

Want to Submit Code?

You can submit code by:

  1. forking the dev branch of this repository, at https://github.com/ivan-hc/AM/tree/dev
  2. install "AM" using this guide https://github.com/ivan-hc/AM?tab=readme-ov-file#installation
  3. also install "AppMan" using this other guide https://github.com/ivan-hc/AppMan?tab=readme-ov-file#installation
  4. use YOUR FORK/BRANCH using the option "newrepo", for example, where your github profile is $USER and your branch is "dev", do:
am newrepo https://raw.githubusercontent.com/$USER/AM/dev
appman newrepo https://raw.githubusercontent.com/$USER/AM/dev
  1. apply your changes on your fork and test them on both "AM" and AppMan until you're sure that they work without any problem
  2. submit a pull request to the "dev" branch, at https://github.com/ivan-hc/AM/tree/dev

Want to contribute to the Development Branch and test newer features?

Enter the developer mode using the command

am --devmode-enable

to go back to the main stable branch instead

am --devmode-disable

NOTE, using the "dev" branch can cause serious risks to system stability. Use at your own risk.

Want to help in some way?

Share the link to this repository on YouTube, Twitter, Reddit, Facebook or any other platform useful for making our work known.

Want to submit a new app?

Guide for skilled people

If you are sure you can create an installation script yourself:

  1. see "Want to Submit Code?", above
  2. use the option -t to create a new script, everything will be created into a directory "am-scripts", on your desktop, containing
  • the installation script under am-scripts/$arch (where "$arch is the name of your architecture, for example x86_64)
  • a file named am-scripts/list containing the line to add in the list of applications (must be reduced to max 80 characters in total)
  • a Markdown file .md with the name of your app, under am-scripts/portable-linux-apps.github.io
  1. install the script in "AM" and AppMan to test if it works for both
am -i $HOME/Desktop/am-scripts/$arch/your-app
appman -i $HOME/Desktop/am-scripts/$arch/your-app
  1. upload the files
  1. this step is optional, add a .png icon with the name lowercased of your app, sizes 128x128, at https://github.com/Portable-Linux-Apps/Portable-Linux-Apps.github.io, undet the directory /icons
  2. let us know about this with a pull request in this order

Guide for beginners

Submit your request at https://github.com/ivan-hc/AM/issues , we'll provide as soon as possible

Credits

  • This document was written by @ivan-hc (owner)
  • The creation of this document is a suggestion from @nazdridoy
  • Also thanks to @zen0bit for supporting