commit | author | age
|
12ec51
|
1 |
# Red Hat Open Innovation Labs Enablement Materials |
D |
2 |
This repo will house all the slides and lab exercises for the Enablement course. It will also be used to track issues, features and new additions to the course. |
|
3 |
|
e94284
|
4 |
[Course Content](https://rht-labs.github.io/enablement-docs/#/) |
12ec51
|
5 |
|
D |
6 |
## Slides |
|
7 |
Use the [Open Innovation Labs reveal.js template](https://github.com/rht-labs/slides-template) to create new content. Add your slides and commit them to the `slides` dir |
|
8 |
|
|
9 |
## Exercises |
c951f7
|
10 |
Exercises are created using [Docsify](https://docsify.js.org/#/). Write docs in Markdown and use [Docsify](https://github.com/QingWei-Li/docsify-cli) cli to serve them. Store your lab exercises in the `exercises/<lab-number>` dir. |
df6f87
|
11 |
|
c951f7
|
12 |
A template layout for the lab exercise with headings and what should be included is stored in `exercises/0-docs-template`. Use this as a base point when creating new materials. Add items to the sidebar on the homepage by updating the `_sidebar` |
12ec51
|
13 |
|
bc2e43
|
14 |
To run and serve the docs |
D |
15 |
1. `npm i -g docsify-cli` |
|
16 |
2. `cd exercises && docsify serve -p 8085 -P 35727` and open your browser to 8085 |
|
17 |
|
e94284
|
18 |
## Publishing |
D |
19 |
The `exercises` folder is served as the root of the gitpages site from master branch. To update the published content run: |
|
20 |
1. `git checkout master` |
|
21 |
2. `git subtree push --prefix exercises origin gh-pages` |
|
22 |
|
|
23 |
|
12ec51
|
24 |
## Contributing & Issues |
cfaea1
|
25 |
For tracking of feature development and task management add the ZenHub plugin extension to [Chrome](https://chrome.google.com/webstore/detail/zenhub-for-github/ogcgkffhplmphkaahpmffcafajaocjbd) or [Firefox](https://www.zenhub.com/extension). |
TB |
26 |
To contribute raise an issue and submit a PR to correspond to that feature. |