contributing.org

Contributing to Mercadolibre - dark

Table of Contents

• Getting Involved
• How to Report Style Issues
  • I don’t know CSS
  • I know both CSS & GitHub
    • Duplicate the style or create a “companion style”
      • Duplicate the style
• Getting Started
  • Style guide
  • Contributing code
  • Testing changes of a local userstyle

Getting Involved

Even if you’ve never contributed to an Open Source project before, I’m always looking for help identifying missing styles or other issues.

How to Report Style Issues

I don’t know CSS

If you don’t know CSS very well and have found a missing style, please include as much as possible of following information when opening an issue:

• Screenshot of the problem
• Include the element(s) in the console if at all possible
  • To select an element, target it with your mouse then right-click and choose “Inspect Element”, otherwise press `Ctrl + Shift + C` and select it with your left mouse click
  • Copy the HTML if at all possible

I know both CSS & GitHub

• Recommended: duplicate the style.
• Follow the style guide below
• Make any needed changes, then send us a pull request
• Please include a URL to the page (if public)

Duplicate the style or create a “companion style”

When a userstyle is installed from a page, Stylus stores the url of that page internally along with the CSS style.

If that userstyle is then modified or even renamed, it will still maintain the original install location, but all automatic updates of the modified userstyle will be blocked to preserve local changes. A manual update of that userstyle is required to update, but be warned that an update will overwrite all changes, i.e. all modifications will be lost!

To get around this duplicate it.

Duplicate the style

The easiest way is to copy and paste the source code into a new, local style.

1. Copy the style
   • Open mercadolibre-dark in the Stylus’ Editor
   • Copy the code directly from the edit window.
   • If not all content is automatically selected in the popped up window, use Select All (Ctrl+A), then Copy (Ctrl+C) the style.
2. Paste into a new style
   • Click “Write new style” in the Stylus’ Manager
   • Paste (Ctrl+V) the style into the code block area.
   • Give the style a name, then save.

Getting Started

Style guide

• Don’t create a new line, if it’s background, text, link or border you will find it, just add a comma before the { and put the new_element after.

  /* good */
    element, new_element { 
        property: value;
    }
  /* bad */
    element { 
        property: value;
    }
    new_element { 
        same-property: same-value;
    }
      

• If you want to add a new userstyle variable/feature, please open an issue and discuss it with us first.
• Don’t include version bumps with your contribution, all releases are handled internally.
• If your pull request (PR) fixes an open issue or replaces another PR, include fixes/closes #issue-number in your commit message title. Read more on this

Contributing code

• Download, fork, or clone this repository
• Create and change into a new branch of your local mercadolibre-dark repository
• Make the changes in the mercadolibre-dark.user.css file and verify that they fix the issue
• Push the changes to your branch
  • Make sure that your changes address only a single issue. Don’t combine multiple fixes for unrelated issues into a single pull request.
• Submit a PR

Testing changes of a local userstyle

• Open the mercadolibre-dark.user.css file in your browser, and make sure to have “live preview” checked for testing
  • If you’re using a Chromium-based browser, go to extensions, open details for Stylus, and enable “Allow access to file URLs”.
• Make some changes then save the file, and Stylus will do its magic.