>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #2796059. --> Reported by: [Richard Buchanan](https://www.drupal.org/user/2638993) >>> <h3 id="summary-problem-motivation">Problem/Motivation</h3> <p>This issue is being created to discuss documentation for the UIkit theme. Any questions or comments should be added here instead of creating a new issue. If any issues are created relating to documentation, they will be marked as a duplicate and referenced here.</p> <p>In order to create useful documentation I will be adding updates with minimal instructions and verbiage. Hopefully this will encourage others to contribute more to the documentation. Anyone is welcome to contribute to the documentation by submitted patches in this issue.</p> <h3 id="summary-proposed-resolution">Proposed resolution</h3> <p>The UIkit documentation is currently being regularly maintained and updated, along with theme development. The goal is to create documentation that is easy to follow yet informative. You can find the documentation in the uikit/uikit_core/docs directory of the theme.</p> <p>An API site has been set up at <a href="http://uikit-drupal.com">uikit-drupal.com</a>. uikit-drupal.com utilizes the API module to parse the docblocks in the UIkit docs folder. I've created several custom docblock tags to style elements with UIkit, so the API module used is a fork of the drupal.org API module. I also created a <a href="https://github.com/richardbuchanan/uikit_api">UIkit API installation profile</a> to allow anyone to create their own UIkit API site for testing/patching purposes. <a href="https://www.drupal.org/docs/7/installing-drupal-7/using-an-installation-profile">Install the profile</a> as you would any Drupal installation profile following these instructions. uikit-drupal.com uses the UIkit theme as a base theme, so it provides a demo of the UIkit theme.</p> <p>I would discourage documenting anything the <a href="http://getuikit.com/docs/documentation_get-started.html">official UIkit Documentation</a> already provides. No need to reinvent the wheel. There may be times we need to ignore this rule, but we should focus documenting the UIkit Drupal theme project (installing, theme settings, developer API, etc.).</p> <h3 id="summary-remaining-tasks">Remaining tasks</h3> <p><span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/uikit/issues/2798293" title="Status: Closed (fixed)">#2798293: Initially hide advanced settings</a></span><br> <span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/uikit/-/work_items/2788889" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/uikit/-/work_items/2788889</a></span></p> <h3 id="summary-ui-changes">User interface changes</h3> <p><span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-6"><a href="https://www.drupal.org/project/uikit/issues/2859466" title="Status: Closed (works as designed)">#2859466: Off-canvas menu not expanding</a></span><br> Use the <a href="https://www.drupal.org/project/uikit_components">UIkit Components</a> module to enable navbar dropdown support mentioned in above issue.</p> <h3 id="summary-api-changes">API changes</h3> <p><span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/uikit/issues/2854101" title="Status: Closed (fixed)">#2854101: Support "Show as expanded" in uk-navbar</a></span><br> <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/uikit/issues/2859925" title="Status: Closed (fixed)">#2859925: Adding component assets</a></span></p>