KXStudio repo install instructions incomplete!

[wolftune]

The instructions on the website don't include the final steps of running an update and then installing the meta packages etc! So, someone following all the instructions doesn't end up with any software!

[falkTX]

The repository page is supposed to be as simple as possible, and only explain how to enable the repositories.

After the repositories are enabled and the system updated, we recommend you to install the "kxstudio-default-settings" package.

[wolftune]

Maybe we're talking past one another. I'm not seeing any place on the KXStudio website where someone goes when they want to "get KXStudio" meaning be told to:

• have a compatible system (which is?)
• add the repos (those instructions are fine)
• add meta packages
  • which? is there a place that references which meta packages are completely contained in others etc?

So they end up with having software installed in the end. There must be some clear place where if you follow the instructions you end up having software to use without browsing the repositories in Synaptic or something.

[falkTX]

I created a page regarding meta-packages http://kxstudio.linuxaudio.org/Documentation:Repository:Meta-Packages
There's a link to it on the documentation section.
Also the repository page contains a link to it too.

I would like to know what you think.

[wolftune]

The meta-packages page seems clear, although I noted that my manually installed packages are:

kxstudio-default-settings
kxstudio-docs
kxstudio-meta-all
kxstudio-meta-wine
kxstudio-repos
kxstudio-repos-gcc5

Anyway, http://kxstudio.linuxaudio.org/Repositories is the main page I had in mind about the clarity to getting KXStudio stuff. "Also consider taking a look at the available meta-packages if you don't know what things to install just yet." might be worded better as something like "to install whole sets of the recommended packages, add appropriate meta-packages" or something like that. It would be best to maybe say:

"Once you have the repos installed, you can either manually install individual packages from the repos or add the meta-packages to automatically install large sets of recommended packages"

or something like that, and make this a prominent thing that people understand is the next step after the repo installation.

[falkTX]

Content updated again. I used your wording as-is :P
What do you think?

[wolftune]

The text is fine, but it would be ideal to update the docs with headers and better clarity that:

• the main thing for KXStudio is the repos (I recently recommended KXStudio to someone with the goal that they add the repos, but they went and ran a virtual machine with the ISO, not understanding that KXStudio was repos first, not a distro mainly)
• The steps should be bold: add repos, update, install meta packages or select software

Ideally, users can skim the page and get the idea and only need to read the fine print to actually accomplish each task.

On the homepage, there's the 3-section idea, Applications, Plugins, Repos… these seem profoundly not similar. The repos contain the other things. Do people get the Apps and Plugins without the repos somehow??

So, I'd change the homepage to say that KXStudio is repos with packages that include three types: Apps, Plugins, accessory tools (like the wine packages and settings etc). Make it really obvious that the primary way to get everything is to add the repos and then install stuff.

[falkTX]

There's a conflict of philosophy/ideas here..
KXStudio is the apps, plugins and repos.
Apps being Carla, Cadence+Tools and soon the MIDI sequencer.
Plugins are the ones made with DPF and DISTRHO Ports (plus other small things like dssi-vst, jackass and fluidplug).
Repos well you already know.
Those 3 things make the kxstudio project.

When something about Carla is released or changed, I publish it on the KX news.
And carla's homepage in under kxstudio.linuxaudio.org (same for Cadence).
Recently I posted about the DPF plugins, which are part of the KXStudio project.

The main plugins page needs a complete rewrite, so don't pay too much attention to it now.

It's true repository contains other things - most of them not made by me or the kxstudio project.
The distinction of the 3 categories needs to be there.

So in your case, instead of recommending kxstudio itself, recommend the 'kxstudio repositories'.
Does this make sense?

[wolftune]

That makes sense. I suppose it's informative to you that this confusion exists (mainly because the repos gives you everything), but indeed I understand that you're saying an Arch user running Cadence and Carla is using KXStudio… I wouldn't have put it that way before, but I can get behind that enough

[thermopylae-tollboothguy]

I dont suppose we could get some instructions for arch users? Surely someone's setup arch with the kx repos..

[falkTX]

Arch is a completely different package system. The kxstudio repos are for debian based only linux distros.