@bipphilippe and @MARZIMA
The the biggest hold up is getting the Jekyll builds as part of the maven builds for OH 2 and the OH Addons. Until we have that established there really is no place for the documentation to go to.
The intent is:
Documentation should go with the repo, so most of the documentation for the core of OH is actually already being hosted and created in the Eclipse SmartHome project. documentation for the core of OH 2 that is different (e.g. installation, differences caused by the use of karaf, additions) should go in the OH 2 core repo. Finally, the documentation for the addons should go with the addons repo. I think a user’s guide probably would go in the OH 2 core project.
The end goal is that the Jekyll markup would be “compiled” as part of the project build and ideally be submitted to the live website. Obviously a lot of details need to be worked out but that is @kai’s stated goal.
We want it to work just like the Eclipse SmartHome project so really this first step is taking what the ESH project has done and port it over to the OH 2 core and OH 2 addons repos.
The relevant repos are:
Use this as the template for what we need to do to get Jekyll setup
openHAB 2 Distro
This is the OH 2 Core repo where stuff like installation guide, user’s guide, etc would be documented.
This is where much of the source code for OH 2 core that doesn’t come from ESH is hosted. The Jekyll framework should be added here but I’m not cure what documents would go here verses in the distro yet.
openHAB 2 Addons
This is where the specific addons documentation would go.
All three of these latter repos need a Jekyll project created and added to the maven builds.
This is the first step.
It really came down to me because I was the last person standing. But I really am struggling to find the time to make any progress on it and as @kai will tell you, we are in desperate need to get this set up so we can start to move forward on actually building the documents themselves. If either or both of you are able and willing to take this on and get it going it would be a great help to me and the rest of the OH community.