richard
/
SemanSemantic-UItic-UI
mirror of https://github.com/Semantic-Org/Semantic-UI.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
5674 Commits
34 Branches
160 Tags
180 MiB
 
 
 
Tree: ea95a2b1c2
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'ea95a2b1c2'
${ noResults }
SemanSemantic-UItic-UI/CONTRIBUTING.md

3.1 KiB
Raw Blame History

Contributing to Semantic UI

Usage Questions

Questions about usage should be asked on the ProjectTalk message board, StackOverflow or Gitter.

Examples of usage questions

  • Why isnt my code working?
  • Can Semantic UI do this?

Once you receive feedback through community channels you may find your question is actually a bug. At this point it's a good idea to submit it as a bug report. Just keep in mind the following suggestions.

Creating Bug Reports

Please create a fork of this jsfiddle to demonstrate bugs.

When submiting a bug report, please include a set of steps to reproduce the issue and any related information, browser, OS etc. If we can't see the issue then it will make solving things much more difficult.

If your bug uses a third party framework like Ember, Meteor, or Angular. Be sure to submit the issue to their respective issues boards. If you are confident the bug is part of the 'vanilla' SUI release, keep in mind not all maintainers are familiar with all framework and a simple test case is greatly appreciated.

If your bug is reproduced by a maintainer it will be asssigned the confirmed bug tag. Browsing this tag is a good way to keep track of known issues with SUI.

Naming Issues

Semantic UI boards use a special naming convention to help tag issue titles by the component the issue is related to.

Bugs

Please tag titles in the format "[Component] (sub-type) should do (correct behavior)". Please use standard title case for titles, including the bracketed tag.

For example

  • [Dropdown] Multiple Selection Should Preserve "Set Selected" Order
  • [Validation] - E-mail Validation Should Handle Cyrillic
  • [Button] - Grouped Buttons Should Display Correctly on Mobile

Enhancements

For new feature requests, you can use the format "[Component] Add (new feature)"

For example

  • [Dropdown] Add "Clearable" Setting
  • [Validation] Add Rules for Zipcode Validation
  • [API] Add "onProgress" callback setting

Github Issues Tracker is used to track all upcoming milestones and changes to the project.

Tracking Issue Progress

As bugs and features are triaged they will be assigned to milestones. The best indication of when a change will land is to check the date on the upcoming milestones page.

Creating Pull Requests

All pull requests should be merged into the next branch.

Anyone can jump on the issues board and grab off bugs to fix. This is probably the best way to become a contributor to Semantic. Be sure to adhere to the style guides when submitting code.