New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Configuration: Add a link to the "demo" example configuration #578
Comments
I would vote for |
Providing them through the Linux packages would make sense! And I'd agree that The "how" gets a little tricky. Since they're not automatically contained in a zipfile for the gradle script to chew on. |
Fine with me. @kaikreuzer wdyt? |
I even wonder if we should move them to the docs completely and remove the demo packaging - especially one we have the home builder merged, which should then become the starting point for new setups (while currently people probably often choose the demo setup as a start). |
@kaikreuzer let's do that! I never really liked the demo package with it's quirks and all too often users realize that they want to check out the demo files after they were able to decide that. With "to the docs" you mean out of the distro into the docs repository? Having them available in docs sounds good to me but as we also need them for @BClark09 and many users will still like to access them directly, how about https://github.com/openhab/openhab-conf-demo |
Hm, good questions. I think for @BClark09 it would probably be ideal if they are still part of the distro (as this is the input for the apt packaging) - we could package them in |
Adding them to |
Fine with me. Imho "demofiles" is a bit unspecific. Consider something with "conf", "config" or "example". I'll leave this issue open till after the change, then work on appropriate docs changes. |
Ok, so let's first get the home builder merged & documented and the demo packaging removed.
Anything is fine for me, please name your favorite :-) |
"example" has my vote. |
+1 for example. I agree with bclark. conf or config could be misunderstood. |
+1 example |
I expected @ThomDietrich to mean democonf/democonfig instead of demofiles as he said "with". So it was about replacing the word "files", not about the absolute name. |
Ah - I missed that part Kai. I would prefer sampleconf or sample-conf (or sample_conf?). |
@kaikreuzer Thank you. Yes 😄 (sample|example|demo)[-_ ](conf(ig|)) Any combination is fine with me. The word "demo" is by now maybe not the best fit. "example" or "sample" would both fit, however in the community we already eastablished the term "example". For the second part I'd have liked "config" better but as the distribution is served with the "conf" folder, that might be the better choice. Hence my vote goes to: |
Ah, glad to see that we sometimes do NOT misunderstand each other ;-)
|
+1 example-conf |
+1 example-conf , sounds good and logic. |
I didn't really make it to address this in time and I feel that removing the demo package now is too risky and will render many screenshots outdated immediately. What I'd like to add though is the Home Builder to some package. I think the "Standard" package is the only candidate as "Simple" does not support items&sitemaps anyhow and "expert" is rather for people who anyhow already have their full setup. Would you agree? |
You can simply vote on openhab/openhab-distro#609 :-) |
https://github.com/openhab/openhab-distro/tree/master/features/distro-resources/src/main/resources
Even if the user didn't select the Demo starting package, he/she might want to look at the example files at some point. There should be a link to them somewhere in configuration.
How about http://docs.openhab.org/configuration/index.html and/or http://docs.openhab.org/configuration/packages.html
Better ideas?
@BClark09 for many Linux packages (*) it is common to provide example configuration files through some location under
/usr/share
. Wdyt?The text was updated successfully, but these errors were encountered: