development-workflow.html 8.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8">
  5. <meta name="viewport" content="width=device-width,initial-scale=1">
  6. <title>UI Development Workflow :: jMonkeyEngine Docs</title>
  7. <link rel="canonical" href="https://wiki.jmonkeyengine.org/wiki-ui/development-workflow.html">
  8. <link rel="prev" href="build-preview-ui.html">
  9. <link rel="next" href="templates.html">
  10. <meta name="generator" content="Antora 2.3.3">
  11. <link rel="stylesheet" href="../_/css/site.css">
  12. </head>
  13. <body class="article">
  14. <header class="header">
  15. <nav class="navbar">
  16. <div class="navbar-brand">
  17. <a class="navbar-item" href="https://wiki.jmonkeyengine.org">jMonkeyEngine Docs</a>
  18. <button class="navbar-burger" data-target="topbar-nav">
  19. <span></span>
  20. <span></span>
  21. <span></span>
  22. </button>
  23. </div>
  24. <div id="topbar-nav" class="navbar-menu">
  25. <div class="navbar-end">
  26. <a class="navbar-item" href="#">Home</a>
  27. <div class="navbar-item has-dropdown is-hoverable">
  28. <a class="navbar-link" href="#">Products</a>
  29. <div class="navbar-dropdown">
  30. <a class="navbar-item" href="#">Product A</a>
  31. <a class="navbar-item" href="#">Product B</a>
  32. <a class="navbar-item" href="#">Product C</a>
  33. </div>
  34. </div>
  35. <div class="navbar-item has-dropdown is-hoverable">
  36. <a class="navbar-link" href="#">Services</a>
  37. <div class="navbar-dropdown">
  38. <a class="navbar-item" href="#">Service A</a>
  39. <a class="navbar-item" href="#">Service B</a>
  40. <a class="navbar-item" href="#">Service C</a>
  41. </div>
  42. </div>
  43. <div class="navbar-item has-dropdown is-hoverable">
  44. <a class="navbar-link" href="#">Resources</a>
  45. <div class="navbar-dropdown">
  46. <a class="navbar-item" href="#">Resource A</a>
  47. <a class="navbar-item" href="#">Resource B</a>
  48. <a class="navbar-item" href="#">Resource C</a>
  49. </div>
  50. </div>
  51. <div class="navbar-item">
  52. <span class="control">
  53. <a class="button is-primary" href="#">Download</a>
  54. </span>
  55. </div>
  56. </div>
  57. </div>
  58. </nav>
  59. </header>
  60. <div class="body">
  61. <div class="nav-container" data-component="wiki-ui" data-version="master">
  62. <aside class="nav">
  63. <div class="panels">
  64. <div class="nav-panel-menu is-active" data-panel="menu">
  65. <nav class="nav-menu">
  66. <h3 class="title"><a href="index.html">Wiki UI</a></h3>
  67. <ul class="nav-list">
  68. <li class="nav-item" data-depth="0">
  69. <ul class="nav-list">
  70. <li class="nav-item" data-depth="1">
  71. <a class="nav-link" href="prerequisites.html">UI Development Prerequisites</a>
  72. </li>
  73. <li class="nav-item" data-depth="1">
  74. <a class="nav-link" href="set-up-project.html">Set up a UI Project</a>
  75. </li>
  76. <li class="nav-item" data-depth="1">
  77. <a class="nav-link" href="build-preview-ui.html">Build and Preview the UI</a>
  78. </li>
  79. <li class="nav-item is-current-page" data-depth="1">
  80. <a class="nav-link" href="development-workflow.html">UI Development Workflow</a>
  81. </li>
  82. <li class="nav-item" data-depth="1">
  83. <a class="nav-link" href="templates.html">Work with the Handlebars Templates</a>
  84. </li>
  85. <li class="nav-item" data-depth="1">
  86. <button class="nav-item-toggle"></button>
  87. <a class="nav-link" href="stylesheets.html">Work with the CSS Stylesheets</a>
  88. <ul class="nav-list">
  89. <li class="nav-item" data-depth="2">
  90. <a class="nav-link" href="add-fonts.html">Add Fonts</a>
  91. </li>
  92. </ul>
  93. </li>
  94. <li class="nav-item" data-depth="1">
  95. <button class="nav-item-toggle"></button>
  96. <a class="nav-link" href="style-guide.html">UI Element Styles</a>
  97. <ul class="nav-list">
  98. <li class="nav-item" data-depth="2">
  99. <a class="nav-link" href="inline-text-styles.html">Inline Text</a>
  100. </li>
  101. <li class="nav-item" data-depth="2">
  102. <a class="nav-link" href="admonition-styles.html">Admonitions</a>
  103. </li>
  104. <li class="nav-item" data-depth="2">
  105. <a class="nav-link" href="list-styles.html">Lists</a>
  106. </li>
  107. <li class="nav-item" data-depth="2">
  108. <a class="nav-link" href="sidebar-styles.html">Sidebars</a>
  109. </li>
  110. <li class="nav-item" data-depth="2">
  111. <a class="nav-link" href="ui-macro-styles.html">UI Macros</a>
  112. </li>
  113. </ul>
  114. </li>
  115. </ul>
  116. </li>
  117. </ul>
  118. </nav>
  119. </div>
  120. <div class="nav-panel-explore" data-panel="explore">
  121. <div class="context">
  122. <span class="title">Wiki UI</span>
  123. <span class="version">master</span>
  124. </div>
  125. <ul class="components">
  126. <li class="component">
  127. <span class="title">Docs</span>
  128. <ul class="versions">
  129. <li class="version is-latest">
  130. <a href="../docs/jme3.html">master</a>
  131. </li>
  132. </ul>
  133. </li>
  134. <li class="component is-current">
  135. <span class="title">Wiki UI</span>
  136. <ul class="versions">
  137. <li class="version is-current is-latest">
  138. <a href="index.html">master</a>
  139. </li>
  140. </ul>
  141. </li>
  142. </ul>
  143. </div>
  144. </div>
  145. </aside>
  146. </div>
  147. <main class="article">
  148. <div class="toolbar" role="navigation">
  149. <button class="nav-toggle"></button>
  150. <a href="../docs/documentation.html" class="home-link"></a>
  151. <nav class="breadcrumbs" aria-label="breadcrumbs">
  152. <ul>
  153. <li><a href="index.html">Wiki UI</a></li>
  154. <li><a href="development-workflow.html">UI Development Workflow</a></li>
  155. </ul>
  156. </nav>
  157. <div class="edit-this-page"><a href="https://github.com/jMonkeyEngine/wiki-ui/edit/master/docs/modules/ROOT/pages/development-workflow.adoc">Edit this Page</a></div>
  158. </div>
  159. <div class="content">
  160. <article class="doc">
  161. <h1 class="page">UI Development Workflow</h1>
  162. <div id="preamble">
  163. <div class="sectionbody">
  164. <div class="paragraph">
  165. <p>All changes pushed to a UI project&#8217;s master branch can trigger a new release (not described here).
  166. Therefore, you want to make your changes to a development branch and submit it as a pull request (PR) to be approved.
  167. (Even better would be to issue the PR from a fork).
  168. Only when the PR is approved and merged will the new release be triggered.</p>
  169. </div>
  170. </div>
  171. </div>
  172. <div class="sect1">
  173. <h2 id="git-steps"><a class="anchor" href="#git-steps"></a>git steps</h2>
  174. <div class="sectionbody">
  175. <div class="paragraph">
  176. <p>Use the following command to create a local development branch named <code>name-me</code>:</p>
  177. </div>
  178. <div class="literalblock">
  179. <div class="content">
  180. <pre>$ git checkout -b name-me -t origin/master</pre>
  181. </div>
  182. </div>
  183. <div class="paragraph">
  184. <p>You&#8217;ll then apply your changes to the UI files.
  185. Once you&#8217;re done making changes, commit those changes to the local branch:</p>
  186. </div>
  187. <div class="literalblock">
  188. <div class="content">
  189. <pre>$ git commit -a -m "describe your change"</pre>
  190. </div>
  191. </div>
  192. <div class="paragraph">
  193. <p>Then, push your branch to the remote repository:</p>
  194. </div>
  195. <div class="literalblock">
  196. <div class="content">
  197. <pre>$ git push origin name-me</pre>
  198. </div>
  199. </div>
  200. <div class="paragraph">
  201. <p>Finally, navigate to your UI project in your browser and create a new pull request from this branch.</p>
  202. </div>
  203. <div class="paragraph">
  204. <p>The maintainer of the UI should review the changes.
  205. If the changes are acceptable, the maintainer will merge the pull request.
  206. As soon as the pull request is merged into master, an automated process will take over to publish a new release for the site generator to use.</p>
  207. </div>
  208. <div class="paragraph">
  209. <p>Now that you&#8217;ve got the process down, let&#8217;s review some of the files you&#8217;ll be working with in more detail.</p>
  210. </div>
  211. </div>
  212. </div>
  213. <nav class="pagination">
  214. <span class="prev"><a href="build-preview-ui.html">Build and Preview the UI</a></span>
  215. <span class="next"><a href="templates.html">Work with the Handlebars Templates</a></span>
  216. </nav>
  217. </article>
  218. <aside class="toc sidebar" data-title="Contents" data-levels="2">
  219. <div class="toc-menu"></div>
  220. </aside>
  221. </div>
  222. </main>
  223. </div>
  224. <footer class="footer">
  225. <p>This page was built using the Antora default UI.</p>
  226. <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
  227. </footer>
  228. <script src="../_/js/site.js"></script>
  229. <script async src="../_/js/vendor/highlight.js"></script>
  230. </body>
  231. </html>