Setting up basic documentation

docs/Contributing.md

@@ -0,0 +1,23 @@
+# Contributing
+
+Warewulf is an open source project and we invite your collaboration and help.
+
+## Contributor's Agreement
+You are under no obligation whatsoever to provide any bug fixes, patches, or upgrades to the features, functionality 
+or performance of the source code ("Enhancements") to anyone; however, if you choose to make your Enhancements 
+available either publicly, or directly to the project, without imposing a separate written license agreement for such
+Enhancements, then you hereby grant the following license: a non-exclusive, royalty-free perpetual license to 
+install, use, modify, prepare derivative works, incorporate into other computer software, distribute, and sublicense
+such enhancements or derivative works thereof, in binary and source code form.
+
+## To Contribute
+Here is the very high level guide to contributing:
+
+* For the project to a location of your choosing
+* Clone your fork locally: `git clone http://github.com/$NAME/warewulf.git`
+* Inside your fork, create a local branch: `cd warewulf; git checkout -b localchanges`
+* Make the necessary changes and commit them: `git commit -a`
+* Push your changes: `git push origin localchanges`
+* Create a PR using GitHub: `https://github.com/$NAME/warewulf/pull/new/localchanges`
+
+*note: set your environment variable `NAME=github_username` before running the above commands.*

docs/README.md

@@ -1,7 +1,21 @@
 # Documentation for Warewulf
 
+The documentation for Warewulf is a work in progress and we are asking for contributions from the open source 
+community on this. Please see the [contributing](Contributing.md) document for how to help out this project.
+
 ### Quickstarts
 
 * [RHEL-7 quickstart](rhel7-quickstart.md)
 * [RHEL-8 quickstart](rhel8-quickstart.md)
 
+### Chapters
+(all coming soon)
+
+* [Introduction](introduction.md)
+* [Architecture](architecture.md)
+* [System Services and Dependencies](system_services.md)
+* [Profiles](profiles.md)
+* [Node Configurations](nodes.md)
+* [Containers and VNFS images](containers.md)
+* [Overlays](overlays.md)
+* [SELinux](selinux.md)

docs/rhel7-quickstart.md

@@ -128,7 +128,7 @@ Here are some of the common `overlay` commands:
 ```
 sudo ./wwctl overlay list -l
 sudo ./wwctl overlay list -ls
-sudo EDITOR=vim ./wwctl overlay edit default /etc/hello_world.ww
+sudo ./wwctl overlay edit default /etc/hello_world.ww
 sudo ./wwctl overlay build -a
 ```
 

docs/rhel8-quickstart.md

@@ -129,7 +129,7 @@ Here are some of the common `overlay` commands:
 ```
 sudo ./wwctl overlay list -l
 sudo ./wwctl overlay list -ls
-sudo EDITOR=vim ./wwctl overlay edit default /etc/hello_world.ww
+sudo ./wwctl overlay edit default /etc/hello_world.ww
 sudo ./wwctl overlay build -a
 ```