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

Get started / Entry Barrier #2922

d3nwp opened this issue Aug 30, 2019 · 4 comments


Copy link

commented Aug 30, 2019

Since I am working on my thesis which is about the entry barriers of floss projects, I am also interested to contribute to elektra and highlight some issues that I faced when I tried to install elektra for the very first time. So lets make a better World (of Elektra) :D -> Error: make cmd not found!

There is already an issue 2891 which points out the main problem = 'overloaded' doc pages and a nontrivial structure.

Reproducing the 'problem':
Just imagine, for the very first time I visited the homepage and I was interested in elektra, so I started watching the video and clicking around to find more information about the project.
The first problem I was confronted with was the navigation to the get started page.
There are three ways to "get started":

  • Green button labeled with "Get Started" on the main page (which is a link to 2nd point of this list)
  • Navigation bar -> Documentation/Getting Started
  • Navigation bar -> Development/Getting Started

Since I wasn't interested in any documentation, I clicked on "Development/Getting Started" and read the information on that page. However, I wasn't satisfied because this page was for developers or contributors of elektra (!?) and the short paragraph wasn't really helpful. Now I navigated back to the main page and clicked the green button. And now I thought that this page contains important content and because of that I read all of the topics and sub-topics and finally reached my goal, the "Installation section". On this page I had to skip a bunch of sub-sections to find the "OS Independent" sub-section (IMO the majority of users are interested in this sub-section) and now it said that I need to visit the Compile page to fulfill the pre-requirements.

I mean it wasn't that hard to find all of this information but I think we should re-write/edit the “Get Started” part and face some entry barriers and overcome newcomer-fear.


This comment has been minimized.

Copy link

commented Aug 31, 2019

Yes, there is certainly a lot of space for improvement. Thank you for the summary.

Related issues are: #280 #1054 #1189

Improvements of documentation style: #1053


This comment has been minimized.

Copy link

commented Sep 10, 2019

I am trying to build the project with -DTOOLS="ALL;website-backend;website-frontend" (as described in but I get an error and I don't know why or how to fix it:


I couldn't find the files which are mentioned in the error log.

My make options in CLion:


This comment has been minimized.

Copy link

commented Sep 11, 2019

I couldn't find the files which are mentioned in the error log.

As far as I can tell, these directories exist in the master branch. Did you maybe accidentally delete them?

I executed the following commands on my machine:

git clone
cd libelektra
mkdir build
cd build
cmake -DTOOLS="ALL;website-backend;website-frontend" ..

. The cmake command reported some (expected) warnings about missing dependencies, but seems to work fine otherwise.


This comment has been minimized.

Copy link

commented Sep 11, 2019

Maybe you read the documentation on the website (which refers to the master branch) but you checked out an older branch (the website was renamed recently).

Make sure that you always pull from the main repo into your repo.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
None yet
3 participants
You can’t perform that action at this time.