Difference between revisions of "HZW Documentation"
(added reference to Category:How2 to guides section) |
(→Guides) |
||
| Line 74: | Line 74: | ||
[[How to document in Netbox|Guide to documenting with Netbox]] | [[How to document in Netbox|Guide to documenting with Netbox]] | ||
| − | Also you might want to check [[:Category: | + | Also you might want to check [[:Category:HowTo|Category:HowTo]] for interesting how2's |
Revision as of 18:04, 25 May 2020
The documentation of all things HZW has the following philosophy:
- General information, processes, methods and how-to's get documented in this Wiki
- Physical and Logical Resources like Servers, IPs, Networks, Services, VLANs etc. get documented in Netbox
- Projects and changes get tracked using Kanboard
Contents
Organizational Documentation
Chat
Our primary tool for communication and coordination is matrix.
To join our matrix server matrix.kabelsalat.it you need a matrix client like riot.
On this Matrix server, there is the "hzw admins" channel.
Plase report there and ask if it's ok If you make changes that have an impact.
Example:
"Hey guys, did $Something at the Database server. Can I reboot it to test it's reboot persistency?"
Answer: "No! $Important-thingy does $important-thing and cannot be disrupted right now! Wait one more hour please!"
Video Conferences
For means of faster communication and collaborative working we use our video conferencing solutions, if needed.
There are no regular hzw meetings. We get together when the need arises.
Coordinate projects
We use kanboard to plan, coordinate and track almost all of our activities.
Please open a ticket in our Kanban Board "team_hzw" if you want to:
- report a bug
- request a change
- think I would be cool to have $thing (even if you don't want to spend time implementing it or don't know how to do it)
Technical Documentation
Our Root Server
We are unsing a Root Server hosted at Strato.
See HZW Root Server for details.
Virtual Machines
All virtual Machines providing services (e.g. not for testing purposes) should be linux have had the basic ansible playbook run on them.
Netbox
We are using Netbox to document all physical and Logical Resources like Servers, IPs, Networks, Services, VLANs etc.
Guides
Guide to documenting with Mediawiki
Guide to documenting with Kanboard
Guide to documenting with Netbox
Also you might want to check Category:HowTo for interesting how2's
