Skip to content
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

install docs updated to jessie and stretch #246

Closed
wants to merge 14 commits into from

Conversation

boyska
Copy link
Member

@boyska boyska commented Feb 16, 2016

look ma, no virtualenv!

This PR only changes docs, nothing else. Therefore to test it you need to run python build_sphinx and look at build/sphinx/html/index.html. More specifically, I have changed only the "sysadmin" section.

Also, it would be great if you could test the documented procedure itself!

@boyska
Copy link
Member Author

boyska commented Mar 11, 2016

rebased to include #266

@boyska
Copy link
Member Author

boyska commented Mar 15, 2016

Could someone please have a look at this PR?



Start libreant
^^^^^^^^^^^^^^
To execute libreant::

On debian stretch, the systemd unit ``python-libreant.service`` will take care
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is wrong; it actually is libreant.service

@cocconat
Copy link
Contributor

Can you explain why do I need to add stretch repo? As debian user I always had many troubles in using testing repo! maybe a standard user will not add testing, if you don't offer an explanation in the wiki. ;)
by the way it compiles and it's clear.

@boyska
Copy link
Member Author

boyska commented Mar 18, 2016

cocco->nat:

Can you explain why do I need to add stretch repo?

yes, python-dominate is the reason. You're also right about your
concerns adding stretch repo to a jessie. I'll a warning providing
additional explanation and providing a command to set the default
release to jessie, so that you won't find with everything upgraded.

@cocconat
Copy link
Contributor

I installed in a Virtualenv, it works fine.
Maybe a lil explanation of what happen after installation should be offered.
something like:
Libreant has configuration file in /etc/libreant, use this folder for presets too, maybe you want to create a daemon in systemd like this:
(e qua la unit)

@boyska
Copy link
Member Author

boyska commented Mar 18, 2016

cocco->nat:

Maybe a lil explanation of what happen after installation should be offered.
something like:
Libreant has configuration file in /etc/libreant

actually it has not. for debian packaging I configured this explicitly,
but that's generally false.
The point is that I should include so many steps!

  • Create a dedicated user
  • Create configuration directory
  • Create systemd unit (and what about non-systemd distros?)
  • Provide a "suggested" libreant.conf
    Basically everything I do in the debian package should be rewritten
    here, explained, AND made portable to different systems. I think that it
    is way too much for an installation guide! If we want to support a
    specific additional distribution, we'd better create a package for it.
    Is there a realistic case in which the sysadmin:
  • can't use a supported distro
  • wants to install system-wide
  • can't just look at the debian package and "steal" from it
    ?

See also how #227 is still open and there is no consensus on the
"default" paths

use this folder for presets too

Again, see #227 : there is no consensus on the canonical PRESET_PATHS,
and nothing about it is implemented in the debian package. This is also
related to #237: only one (and very minimal) preset is provided.

@boyska boyska closed this Jul 28, 2016
@boyska boyska deleted the debian-repo-doc branch July 28, 2016 08:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants