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.

102 lines
5.8 KiB

  1. ---
  2. layout : 'default'
  3. css : 'contribute'
  4. title : 'Contributing'
  5. description : 'It takes a village'
  6. type : 'Semantic Project'
  7. ---
  8. <script src="/javascript/intro.js"></script>
  9. <%- @partial('header') %>
  10. <div class="main container">
  11. <div class="peek">
  12. <div class="ui vertical pointing secondary menu">
  13. <a class="active item">Introduction</a>
  14. <a class="item">Contributing</a>
  15. <a class="item">Specification</a>
  16. </div>
  17. </div>
  18. <h2 class="ui dividing header">Introduction</h2>
  19. <p>There are a variety of ways to contribute to the development of Semantic. We are a very new project and are looking for an enthusiastic and like-minded group of core contributors. We use the lovely free project management software <a href="https://trello.com/jack148/recommend">Trello</a> for keeping track of project issues and updates.</p>
  20. <p>Some Trello boards are open publicly, others are limited to contributors. Anyone can share ideas for the direction of the project using our public boards.</p>
  21. <p>If you are looking to be added to contributor board on Semantic and are active in development, please reach out to me by e-mail <a href="mailto:jack@myfav.es">jack@myfav.es</a></p>
  22. <h3 class="ui header">Publicity</h3>
  23. <p>One of the easiest ways to support Semantic UI is to get the word out</p>
  24. <script id='fbrob7c'>(function(i){var f,s=document.getElementById(i);f=document.createElement('iframe');f.src='//api.flattr.com/button/view/?uid=jlukic&button=compact&url=https%3A%2F%2Fgithub.com%2Fjlukic%2FSemantic-UI';f.title='Flattr';f.height=31;f.width=110;f.style.marginRight=10;f.style.borderWidth=0;s.parentNode.insertBefore(f,s);})('fbrob7c');</script>
  25. <iframe src="http://ghbtns.com/github-btn.html?user=jlukic&repo=semantic=ui&type=watch&count=true&size=large"
  26. allowtransparency="true" frameborder="0" scrolling="0" width="90" height="30"></iframe>
  27. <iframe src="http://ghbtns.com/github-btn.html?user=jlukic&repo=semantic=ui&type=follow&count=true&size=large"
  28. allowtransparency="true" frameborder="0" scrolling="0" width="170" height="30"></iframe>
  29. <iframe src="http://ghbtns.com/github-btn.html?user=jlukic&repo=semantic=ui&type=fork&count=true&size=large"
  30. allowtransparency="true" frameborder="0" scrolling="0" width="90" height="30"></iframe>
  31. <a href="https://twitter.com/intent/tweet?button_hashtag=semanticui" class="twitter-hashtag-button" data-size="large" data-url="http://www.semantic-ui.com"></a>
  32. <script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script>
  33. <h2 class="ui dividing header">Making Semantic Better</h2>
  34. <h3 class="ui dividing header">Bugs & Issues</h3>
  35. <p>Please submit any bugs you encounter when using the library to our <a href="https://github.com/jlukic/Semantic-UI/issues?state=open">Github Issues Tracker</a>.</p>
  36. <p>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.</p>
  37. <h3 class="ui header">Style Guide</h3>
  38. <p>Contributors should read over the coding guidelines for the project. Most importantly, the guide for language, as it is one of the most important parts about Semantic UI.</p>
  39. <a class="ui secondary button" href="/guide/styleguide.html">Language</a>
  40. <a class="ui button" href="/guide/cssguide.html">CSS</a>
  41. <a class="ui button" href="/guide/javascriptguide.html">Javascript</a>
  42. <h3 class="ui dividing header">Pull Requests</h3>
  43. <p>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.</p>
  44. <ul class="ui list">
  45. <li><a href="https://github.com/jlukic/Semantic-UI/compare/">Create a Pull Request</a></li>
  46. <li><a href="https://github.com/jlukic/Semantic-UI/issues?state=open">View Open Issues</a></li>
  47. </ul>
  48. <h3 class="ui dividing header">Expanding UI</h3>
  49. <p>Semantic is looking for people to help contribute new core UI components, and suggest extensions for the library.</p>
  50. <p>If you have suggestions for components missing from Semantic which you'd like to see in future versions please add them to our public UI Component board. The current list of upcoming components, and their current development status can be seen on the contributor UI board.</p>
  51. <h4 class="ui header">Visit UI Development Boards</h4>
  52. <div class="ui buttons">
  53. <a class="ui button" href="https://trello.com/b/Q8uTLy2T">Public</a>
  54. <a class="ui button" href="https://trello.com/b/yVsh5Rds">Contributor</a>
  55. </div>
  56. <h2 class="ui diving header">Specification Development</h2>
  57. <p>We're looking currently for ideas on the best way to expand Semantic to include both core library and third party components. This requires creating a component specification which can be used by anyone to create ui components, and a package management system (website or command line) for authors to distribute them.</p>
  58. <p>These features are very important for the healthy growth of the Semantic ecosystem, and to expand the number of components available to users.</p>
  59. <h4 class="ui header">Visit Community Development Boards</h4>
  60. <div class="ui buttons">
  61. <a class="ui button" href="https://trello.com/b/FZvMsVIM">Public</a>
  62. <a class="ui button" href="https://trello.com/b/eOoZwNBQ">Contributor</a>
  63. </div>
  64. <div class="ui divider"></div>
  65. <a class="ui large right labeled teal icon button" href="/project/development.html">
  66. Next: Developing Semantic
  67. <i class="right arrow icon"></i>
  68. </a>
  69. </div>