ityonemo

ityonemo

Maybe it’s crazy to reinvent the wheel, but I never really liked the fiddliness (and yaml-ness) (and python-ness) of Ansible, so I built this. I’m currently using this to set up some (metal!) servers in a datacenter.

Showing Posts 1 to 10

Exadra37

Exadra37

What was the reasoning behind the choice of the name for the Library? I ask because is not giving any clue about what the Library is doing.

The docs don’t give any concrete examples how to do what the library says it does:

A simple, imperative DSL for remotely provisioning and setting up linux-based servers.

dimitarvp

dimitarvp

I am going to second @Exadra37 here. You should put a very brief how-to at the top of the page..

ityonemo

ityonemo OP

Oh yeah that’s a good point. This information is in the readme and the guides. I’ll also put it up on the docs first page.

dimitarvp

dimitarvp

Many people, myself included, click a link and if they don’t see immediately what the thing is about will just mutter “WTF is this?” and leave, likely to never return.

ityonemo

ityonemo OP

Thanks for the input! I figured out how to wrangle hexdocs to get it to display a more comprehensive, introductory example as the index page, so it’s been updated now. Happy to take more criticism on the docs, it’s always tough when you know intuitively “how it’s supposed to work” but others might not.

Exadra37

Exadra37

It’s still not having a working example of using the library, just some wording, and that is not enough to hook visitors, at least the ones like me :wink:

ityonemo

ityonemo OP

are you seeing the dhcp server example?

EDIT:

use this link, sorry:

Exadra37

Exadra37

Yes I can see it now, but the link in topic is not showing that. I think the landing page should be clear and contain a working example.

ityonemo

ityonemo OP

Unfortunately I can’t edit the top post in the topic.

Exadra37

Exadra37

You can ask the moderator to fix it for you, but I think you are missing the point…

As it stands now, the landing page of your library is the link you have in the topic, and that landing page doesn’t have nothing that gives me a clue of what the module is capable, as said before, a real world working example.

If you keep it as it is the success of your library will be affected, because the majority of us will do what @dimitarvp told you:

See the Domo library for an example of what we are recommending you to do. Can you see that the code examples start immediately after the introduction, thus catching immediately the developer attention, after all we love code :wink:

Where Next? Top

Trending in Announcing Top

woylie
Flop is an Elixir library that applies filtering, ordering and pagination parameters to your Ecto queries. offset-based pagination with...
New
MRdotB
I needed to reuse React components from my Chrome extension in my Phoenix/LiveView backend. I noticed that for Svelte/Vue, there are live...
New
woylie
I released Doggo, a collection of unstyled Phoenix components. https://github.com/woylie/doggo Features Unstyled Phoenix components....
New
marciok
Hi there! We created Gust: A task orchestrator inspired by Airflow. For those who have never heard about Aiflow, it’s a Python-based wor...
New
anuaralfetahe
Hello Published a new library - ProcessHub! ProcessHub is a library designed to manage process distribution within the Elixir cluster. ...
New
jimsynz
Beam Bots (or just BB for short) is a framework for building fault-tolerant robotics applications in Elixir using familiar OTP patterns. ...
New
Dmk
Xamal is a deployment tool for Elixir apps that deploys native releases to bare metal servers over SSH. It’s a port of GitHub - basecamp/...
New

Other Trending Topics Top

ElixirConf
Failing to Introduce Elixir - John Darrington https://www.youtube.com/watch?v=KjAH68yVnh8 Comments welcome! View the <span class="hasht...
New
mudasobwa
I am happy to introduce the very α version of the new programming language compiled to BEAM. Welcome Cure. It has literally three kille...
New
webofbits
With AI doing more of the implementation work, I’ve been wondering how much coding I should deliberately keep doing myself. My main conc...
#ai
New
sergio
It’s not that it’s vocabulary is too advanced. It’s something worse. I get lost trying to follow even a paragraph written by Claude. It’...
New
AstonJ
This showed up on my feed.. anyone heard of it? Just hype? Ox Alpha is a reasoning model designed for coding, sustained ag...
New
bartblast
Hey folks, I just published a post about Hologram’s funding and where the project goes next - the short version: Curiosum as Main Spons...
New

We're in Beta

About us Mission Statement

Options

Thread Display Mode




Thread Preview

Skip Thread Previews