diff --git a/docs/.pages b/docs/.pages new file mode 100644 index 0000000..4f02386 --- /dev/null +++ b/docs/.pages @@ -0,0 +1,8 @@ +--- +nav: + - ... | index.md + - ... | members.md + - Documentation: documentation + - Guidelines: guidelines + - SOP: sop +... diff --git a/docs/documentation/.pages b/docs/documentation/.pages new file mode 100644 index 0000000..06765ee --- /dev/null +++ b/docs/documentation/.pages @@ -0,0 +1,4 @@ +--- +nav: + - ... | index.md +... diff --git a/docs/documentation/index.md b/docs/documentation/index.md new file mode 100644 index 0000000..b5a0c21 --- /dev/null +++ b/docs/documentation/index.md @@ -0,0 +1,8 @@ +--- +title: Documentation +--- + +This section goes over various Documentation for the Testing team. Please +use the menu items to find the various pages of interest. + +{% include "content_bottom.md" %} diff --git a/docs/guidelines/.pages b/docs/guidelines/.pages new file mode 100644 index 0000000..06765ee --- /dev/null +++ b/docs/guidelines/.pages @@ -0,0 +1,4 @@ +--- +nav: + - ... | index.md +... diff --git a/docs/guidelines/index.md b/docs/guidelines/index.md new file mode 100644 index 0000000..17b57c6 --- /dev/null +++ b/docs/guidelines/index.md @@ -0,0 +1,11 @@ +--- +title: Guidelines +--- + +This section goes over guidelines that the Testing team has set out for +anything related to the infrastructure used for testing Rocky Linux. + +All guidelines are listed on the left side of this page. + +{% include "content_bottom.md" %} + diff --git a/docs/include/contacts_top.md b/docs/include/contacts_top.md new file mode 100644 index 0000000..23b387d --- /dev/null +++ b/docs/include/contacts_top.md @@ -0,0 +1,7 @@ +## Contact Information +| | | +| - | - | +| **Owner** | Testing Team | +| **Email Contact** | testing@rockylinux.org | +| **Mattermost Contacts** | `@stack`, `@tcooper` | +| **Mattermost Channels** | `~Testing` | diff --git a/docs/include/content_bottom.md b/docs/include/content_bottom.md new file mode 100644 index 0000000..0a3017c --- /dev/null +++ b/docs/include/content_bottom.md @@ -0,0 +1,16 @@ + +

Additional Information

+ +=== "Contact" + + If you have questions with respect to this content or to report concerns regarding the use or misuse content please do not hesitate to contact us at [info@rockylinux.org](mailto:info@rockylinux.org). + + +=== "Disclaimer" + + Rocky Linux and the Rocky Enterprise Software Foundation (RESF) does not make any express or implied warranties, including but not limited to the warranties of non-infringement of any third party intellectual property rights. RESF does not warrant that any pending trademark applications for trademarks of RESF will result in any granted trademark protection. RESF shall not be liable for any claims relating to user's activities falling within the scope of the permission and user hereby agrees to indemnify, defend and hold RESF and its contributors harmless against any such claim. + +=== "License" + + This content is licensed under under [Attribution-Share Alike 4.0 International](https://creativecommons.org/licenses/by-sa/4.0/) license unless otherwise noted. + diff --git a/docs/include/members_full.md b/docs/include/members_full.md new file mode 100644 index 0000000..7e54409 --- /dev/null +++ b/docs/include/members_full.md @@ -0,0 +1,10 @@ +| Role | Name | Email | Mattermost Name | IRC Name | +| -------------- | --------------- | ----------------------- | ------------------ | --------- | +| Testing Lead | Chris Stackpole | stack@rockylinux.org | @stack | | +| Testing Team | Al Bowles | | @raktajino | raktajino | +| Testing Team | Trevor Cooper | tcooper@rockylinux.org | @tcooper | | +| Testing Team | Lukas Magauer | lukas@magauer.eu | @lumarel | | +| Testing Team | Alan Marshall | | @alangm | alangm | +| Testing Team | Rich Alloway | | @ralloway | | +| Testing Team | Anthony Navarro | | @anavarro10 | | + diff --git a/docs/include/members_no_role.md b/docs/include/members_no_role.md new file mode 100644 index 0000000..875f7df --- /dev/null +++ b/docs/include/members_no_role.md @@ -0,0 +1,11 @@ + + | Name | Email | Mattermost Name | IRC Name | + | --------------- | ----------------------- | ------------------ | --------- | + | Chris Stackpole | stack@rockylinux.org | @stack | | + | Al Bowles | | @raktajino | raktajino | + | Trevor Cooper | tcooper@rockylinux.org | @tcooper | | + | Lukas Magauer | lukas@magauer.eu | @lumarel | | + | Alan Marshall | | @alangm | alangm | + | Rich Alloway | | @ralloway | | + | Anthony Navarro | | @anavarro10 | | + diff --git a/docs/index.md b/docs/index.md index 660f88e..372918f 100644 --- a/docs/index.md +++ b/docs/index.md @@ -2,15 +2,21 @@ ## Links +- Rocky Linux Mattermost: [~Testing](https://chat.rockylinux.org/rocky-linux/channels/testing) +- Rocky Linux openQA: [https://openqa.rockylinux.org](https://openqa.rockylinux.org) + + ## Responsibilities +The Testing Team handles testing and QA for Rocky Linux. + ## Meetings / Communications +- Weekly Team Meeting: [Zoom](https://us02web.zoom.us/j/82494804987?pwd=S1VYKzhmVHZKYnYvUE8zTGlMeG9CZz09) + + ## Members -## Project layout +For a list of our members, see the [Members](members.md) page. - mkdocs.yml # The configuration file. - docs/ - index.md # The documentation homepage. - ... # Other markdown pages, images and other files. +{% include "content_bottom.md" %} diff --git a/docs/members.md b/docs/members.md new file mode 100644 index 0000000..7d96e04 --- /dev/null +++ b/docs/members.md @@ -0,0 +1,7 @@ +--- +title: Members +--- + +{% include "members_full.md" %} + +{% include "content_bottom.md" %} diff --git a/docs/sop/.pages b/docs/sop/.pages new file mode 100644 index 0000000..a545ed5 --- /dev/null +++ b/docs/sop/.pages @@ -0,0 +1,6 @@ +--- +nav: + - ... | index.md + - 'SOP: openQA Operator Access Request': 'openqa_sop_operator_access.md' + - 'SOP: openQA Operator Access Removal': 'openqa_sop_operator_removal.md' +... diff --git a/docs/sop/index.md b/docs/sop/index.md new file mode 100644 index 0000000..2481e21 --- /dev/null +++ b/docs/sop/index.md @@ -0,0 +1,9 @@ +--- +title: SOP (Standard Operationg Procedures) +--- + +This section goes over the various SOP's for the Testing Team. Please use the menu items +to find the various pages of interest. + +{% include "content_bottom.md" %} + diff --git a/docs/sop/openqa_sop_operator_access.md b/docs/sop/openqa_sop_operator_access.md new file mode 100644 index 0000000..8f6bf8d --- /dev/null +++ b/docs/sop/openqa_sop_operator_access.md @@ -0,0 +1,13 @@ +--- +title: 'SOP: openQA - Operator Access Request' +--- + +This SOP covers how the Rocky Linux Testing Team handles requests for Operator access to the openQA system. + +{% include "contacts_top.md" %} + +## Responding to an openQA Operator Access Request + +TODO + +{% include "content_bottom.md" %} diff --git a/docs/sop/openqa_sop_operator_removal.md b/docs/sop/openqa_sop_operator_removal.md new file mode 100644 index 0000000..170da4e --- /dev/null +++ b/docs/sop/openqa_sop_operator_removal.md @@ -0,0 +1,13 @@ +--- +title: 'SOP: openQA - Operator Access Removal' +--- + +This SOP covers how the Rocky Linux Testing Team handles requests for Operator access *removal* on the openQA system. + +{% include "contacts_top.md" %} + +## Responding to an openQA Operator Access Removal + +TODO + +{% include "content_bottom.md" %} diff --git a/mkdocs.yml b/mkdocs.yml index ecc14f5..6141acd 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -58,6 +58,8 @@ plugins: - git-revision-date-localized: type: date - search + - macros: + include_dir: docs/include # Extensions markdown_extensions: