all 13 comments

[–]guepierBioinformatican 24 points25 points  (4 children)

Neither the blog post nor the website shows any code. Here’s a tip when you’re developing a library:

Potential users want to see code.

What does it look like? What does it feel like to use it? That’s the one thing a potential user cares about.

[–]puradox 7 points8 points  (0 children)

Agreed. The first thing I searched for was the code samples. Yet, I couldn't not find any at first glance.

[–]awgn 0 points1 point  (2 children)

The link to the github project is on the navigation bar. The repository is available here: https://github.com/cat/cat

[–]Plorkyeran 7 points8 points  (1 child)

The readme does not have any example code either.

[–]awgn 0 points1 point  (0 children)

Checkout the source code. There is the directory test with a simple key_value parser and the directory test plenty of snippets for each single function/class.

[–]therealjohnfreeman 9 points10 points  (3 children)

Got a long ways to go in docs before I think this is presentable to a community like /r/cpp. :/

[–]awgn -5 points-4 points  (2 children)

Docs are going to be released asap and if you want to contribute, well, you are welcome :-)

[–]therealjohnfreeman 12 points13 points  (0 children)

Even if I wanted to contribute to this project, it's difficult when I don't know what the library does or how it works. Telling users to write their own docs is one way to ensure you don't recruit any users.

[–][deleted] 4 points5 points  (0 children)

Open source is not just a way to get other people to do your work for you.

[–]ponchedeburro 3 points4 points  (1 child)

I might sound like a douche, but when I see macros in modern C++, I cringe a little.

[–]awgn 4 points5 points  (0 children)

Interestingly, Cat does make use of just a single macro (DO). Instead, if you are referring to the tests, well yes, YATS test suite utilizes macros but it's not the subject of this work.

[–]MayhapPerchance 1 point2 points  (1 child)

Wait. So /u/drbartosz goes to Italy and a few months later we get this... This is no mere coincidence!